BMAD Method - Entwickler-Guide
Die BMAD-Methode ist ein KI-gesteuertes agiles Entwicklungs-Framework, das strukturierte Planung, benannte Agents, wiederverwendbare Skills und phasenweise Workflows auf Coding-Assistenten wie Claude Code, Cursor und Codex aufsetzt. Dieser Guide erklärt, was BMAD ist, wo es hilft, wo es übertrieben ist und wie man es gut einsetzt, ohne den eigenen Workflow in ein Zeremonien-Theater zu verwandeln.
Dieser Guide basiert auf der offiziellen BMAD-Method-Dokumentation und dem offiziellen BMAD-METHOD-GitHub-Repository, geprüft am 24. Juni 2026.
1. Was ist BMAD?
BMAD steht für Build More Architect Dreams. Es ist nicht „nur ein weiterer Coding-Assistent" und auch nicht bloß ein Prompt-Paket. Das bessere mentale Modell ist:
| Ebene | Rolle |
|---|---|
| Deine KI-IDE / dein Coding-Agent | Erledigt das eigentliche Lesen, Editieren, Ausführen von Befehlen und die Implementierung |
| BMAD-Methode | Ergänzt Workflow-Struktur, Planungsphasen, benannte Personas und wiederverwendbare Skills |
| Projekt-Artefakte | PRDs, Architektur-Dokumente, Stories, UX-Specs und Kontextdateien, die sich über den Prozess hinweg ansammeln |
Die offizielle BMAD-Doku beschreibt es als Framework, das Teams hilft, von Idee und Analyse über Planung und Architektur in die Implementierung zu gelangen und dabei den Grad der Strenge an die Größe der Aufgabe anzupassen.
Die Kernidee
Die meisten KI-Coding-Sitzungen scheitern aus langweiligen Gründen:
- der Prompt ist vage
- der Agent hat keinen stabilen Projektkontext
- die Aufgabe ist zu groß für einen Chat
- niemand hat die Entscheidungen aufgeschrieben, von denen der nächste Schritt abhängt
BMAD versucht das zu beheben, indem es den Agent eine progressive Kontext-Pipeline durchlaufen lässt statt eines einzigen überdimensionierten Prompts.
2. Warum Entwickler es nutzen
BMAD ist attraktiv, wenn du willst, dass die KI eher wie ein strukturierter Mitarbeiter agiert als wie eine rohe Autocomplete-Engine.
Die wichtigsten Vorteile
| Vorteil | Warum es wichtig ist |
|---|---|
| Phasenweiser Workflow | Du kommst von der Idee zur Implementierung, ohne jeden Schritt zu improvisieren |
bmad-help-Anleitung | Das System prüft den Projektzustand und empfiehlt die nächste sinnvolle Aktion |
| Benannte Agents | Verschiedene Rollen wie PM, Architekt, UX-Designer und Engineer haben klarere Verantwortlichkeiten |
| Generierte Skills | Workflows werden per Name aufgerufen, statt sie jedes Mal neu zu schreiben |
| Skalierungsadaptive Tracks | Ein Bugfix braucht keine Enterprise-Zeremonie, ein Plattform-Build wahrscheinlich schon |
| Projekt-Kontextdateien | Die KI kann sich über Sitzungen hinweg an deinem Stack, deinen Konventionen und Constraints ausrichten |
Was es von einem einfachen Coding-Agent unterscheidet
Ein normaler Coding-Agent ist optimiert für:
- ein Repo
- eine Sitzung
- einen Prompt
- eine Implementierungsschleife
BMAD ist optimiert für:
- wiederholbare Planung
- artefaktgetriebene Übergaben
- Zusammenarbeit über mehrere Rollen
- große oder mehrdeutige Projekte
- den Überblick über viele Chats hinweg
3. Voraussetzungen, Installation und erste Nutzung
Das war einer der fehlenden praktischen Teile: BMAD ist keine eigenständige Desktop-App. Es ist eine per npm installierte Framework-Ebene, die Skills und Workflows für deine KI-IDE generiert.
Voraussetzungen
Laut offiziellem Getting-Started-Guide sind die grundlegenden Voraussetzungen:
- Node.js 20.12+
- Git wird empfohlen
- eine KI-gestützte IDE wie Claude Code, Cursor oder ein ähnliches unterstütztes Tool
- ein Projektordner oder Repo, in dem du BMAD nutzen willst
Installation
Führe in deinem Projektverzeichnis aus:
npx bmad-method install
Wenn du den Prerelease-Channel willst:
npx bmad-method@next install
Die offizielle Doku empfiehlt, bei der Abfrage zuerst das Kernmodul BMad Method zu wählen.
Was der Installer anlegt
Der Installer legt an:
_bmad/für Agents, Workflows, Tasks und Konfiguration_bmad-output/für generierte Artefakte
Wie man es das erste Mal ausführt
Nach der Installation:
- öffne das Projekt in deiner KI-IDE
- starte einen frischen Chat
- rufe
bmad-helpauf - folge dem nächsten empfohlenen Workflow
Die offizielle Doku ist hier eindeutig: Du musst für die normale Workflow-Nutzung nicht zuerst manuell Agents laden. Du kannst Workflow-Skills direkt per Name aufrufen, etwa:
bmad-helpbmad-prdbmad-quick-devbmad-create-architecture
Du kannst auch direkt einen Agent-Skill aufrufen, wenn du ein rollenspezifisches Gespräch willst, zum Beispiel:
bmad-agent-pmbmad-agent-architectbmad-agent-ux-designer
Der einfachste Weg
Der offizielle Getting-Started-Pfad ist im Wesentlichen:
- BMAD installieren
bmad-helpausführen- dich Workflow für Workflow leiten lassen
Für die meisten Teams ist das das richtige Verhalten beim ersten Start.
4. Das Wichtigste zum Verstehen
BMAD ist am besten, wenn das Problem unzureichend spezifiziert oder groß genug ist, dass die Planungsqualität das Ergebnis verändert.
Es geht in erster Linie nicht darum, Code schneller zu generieren. Es geht darum, die Qualität von Folgendem zu verbessern:
- Problemformulierung
- Anforderungsformung
- Architektur-Entscheidungen
- Story-Zerlegung
- Implementierungs-Übergabe
Wenn deine Aufgabe „benenne drei Methoden um und repariere einen Test" lautet, kann BMAD zu viel sein. Wenn deine Aufgabe lautet „mach aus dieser Idee ein Produkt mit Anforderungen, Architektur und einer sinnvollen Build-Reihenfolge", dann ergibt BMAD deutlich mehr Sinn.
Nutze BMAD, wenn das fehlende Teil meist Klarheit ist, nicht nur Tippgeschwindigkeit.
5. Wie BMAD aufgebaut ist
Die offizielle Workflow-Map gliedert BMAD in vier Phasen plus einen leichteren Schnellpfad.
| Phase | Was passiert |
|---|---|
| Analyse | Brainstorming, Recherche, Produkt-Brief, PRFAQ, Belastungstest der Idee |
| Planung | PRD-Erstellung und optionales UX-Design |
| Solutioning | Architekturarbeit und Prüfungen der Implementierungsreife |
| Implementierung | Sprint-Planung, Story-Ausführung, Review und Auslieferung |
| Quick Flow | Verdichteter Pfad für kleinere Arbeiten, bei denen die volle Methode übertrieben wäre |
Die Tracks
BMAD rahmt derzeit drei Planungs-Tracks ein:
| Track | Am besten für | Typischer Output |
|---|---|---|
| Quick Flow | Bugfixes, kleine Features, klarer Scope | Leichtgewichtige Spec plus Implementierung |
| BMad Method | Produktarbeit, größere Features, echter Planungsbedarf | PRD, Architektur, Stories, optionales UX |
| Enterprise | Große Systeme, strengere Kontrollen, mehr übergreifende Belange | Tiefere Planung, Architektur, Sicherheit, betriebliche Aspekte |
Die BMAD-Doku sagt ausdrücklich, den Track nach Planungsbedarf zu wählen und nicht zwanghaft auf einen Schwellenwert für die Story-Anzahl zu starren.
6. Die Teile, mit denen du tatsächlich arbeitest
6.1 bmad-help
Das ist der wichtigste Einstiegspunkt. Es ist BMADs kontextbewusster Leitfaden:
- es prüft, welche Artefakte bereits existieren
- es prüft, welche Module und Workflows verfügbar sind
- es empfiehlt zuerst den nächsten erforderlichen Schritt, dann optionale
Wenn du BMAD installierst und nicht weißt, wo du anfangen sollst, fang hier an.
6.2 Skills
BMAD generiert bei der Installation Skills. Das sind vorgefertigte Prompts, die deine IDE direkt aufrufen kann, zum Beispiel:
bmad-helpbmad-prdbmad-quick-devbmad-create-architecturebmad-sprint-planning
Die generierten Skills liegen in einem IDE-spezifischen Verzeichnis wie:
| IDE / CLI | Skills-Verzeichnis |
|---|---|
| Claude Code | .claude/skills/ |
| Cursor | .agents/skills/ |
| Windsurf | .agents/skills/ |
6.3 Benannte Agents
BMAD liefert außerdem benannte Agent-Personas wie:
- Mary für Analyse
- John für Produktmanagement und Planung
- Sally für UX
- Winston für Architektur
- Amelia für Implementierung
Das sind nicht nur Maskottchen. Die Doku beschreibt sie als Ebene, die verwandte Skills in eine stabilere Rolle und einen stabileren Interaktionsstil einhüllt.
6.4 Ausgabe-Ordner
Eine Standardinstallation legt an:
_bmad/für Agents, Workflows, Tasks und Konfiguration_bmad-output/für generierte Artefakte
Diese Trennung ist nützlich. Sie hält die Framework-Bestandteile von den Dokumenten fern, die Teil deines Projektprozesses werden.
7. Wie man BMAD gut einsetzt
Hier liegt der größte Teil des echten Mehrwerts.
7.1 Starte mit dem Kernmodul, nicht dem ganzen Universum
Installiere BMAD, wähle zuerst das Kernmodul BMad Method und lerne den Ablauf, bevor du spezialisierte Module oder Web-Bundles hinzufügst.
npx bmad-method install
Wenn du zusätzliche Module aufstapelst, bevor du den grundlegenden Workflow verstanden hast, erzeugst du schneller Komplexität als Klarheit.
7.2 Nutze bmad-help als deine Eingangstür
Die beste BMAD-Gewohnheit ist einfach:
- installiere es
- öffne das Repo in deiner KI-IDE
- führe
bmad-helpaus - folge dem nächsten empfohlenen Workflow
Das ist besser, als Befehle auswendig zu lernen oder zu versuchen, das System zu früh auszutricksen.
7.3 Verwende einen frischen Chat pro Workflow
Der offizielle Getting-Started-Guide empfiehlt ausdrücklich einen frischen Chat für jeden Workflow. Das ist eine der aussagekräftigsten Gewohnheiten im gesamten System.
Warum es wichtig ist:
- du reduzierst Kontext-Drift
- du vermeidest, einen Schritt mit Überresten eines anderen zu verunreinigen
- du sorgst dafür, dass Artefakte und nicht der Chat-Verlauf das Projekt vorantreiben
7.4 Wähle den kleinsten Track, der die Qualität noch schützt
Das ist der Haupt-Einführungsfehler: Leute machen entweder zu viel BMAD für eine winzige Aufgabe oder zu wenig BMAD für eine komplexe.
Guter Default:
- nutze Quick Flow für kleine, abgegrenzte Änderungen
- nutze die volle BMad Method, wenn Anforderungen oder Architektur noch unscharf sind
- nutze das Enterprise-Mindset nur, wenn das System tatsächlich diesen Grad an Risiko oder Koordinationsaufwand hat
7.5 Behandle Artefakte als Single Source of Truth
BMAD funktioniert, weil jede Phase Dokumente produziert, die die nächste speisen. Wenn du die Artefakte ignorierst und weiter über ad-hoc-Chat-Nachrichten steuerst, verlierst du den Sinn der Methode.
Das wichtige Mindset ist:
- Entscheidungen kommen in Dokumente
- spätere Workflows konsumieren diese Dokumente
- die Implementierung sollte den schriftlichen Plan widerspiegeln, sofern du ihn nicht bewusst überarbeitest
7.6 Nutze Projektkontext früh bei bestehenden Codebasen
Für etablierte Projekte empfiehlt die BMAD-Doku, project-context.md zu generieren, damit sich die Agents an deinen aktuellen Konventionen ausrichten.
bmad-generate-project-context
Das ist besonders wertvoll, wenn das Repo bereits ausgeprägte Muster für Folgendes hat:
- Architektur
- Namensgebung
- Testing
- Framework-Konventionen
- Deployment-Constraints
7.7 Führe den Installer erneut aus, wenn sich dein Modul-Setup ändert
BMAD generiert Skills aus den aktuell installierten Modulen. Wenn du später Module hinzufügst oder entfernst, führe den Installer erneut aus, damit der Skill-Satz synchron bleibt.
Das wird leicht übersehen und kann die Umgebung „kaputt" wirken lassen, obwohl sie eigentlich nur veraltet ist.
8. Empfohlene Workflows
8.1 Neues Produkt oder großes Feature
Hier ist BMAD am stärksten.
Empfohlener Pfad:
- Führe
bmad-helpaus - Nutze Analyse-Workflows, wenn die Idee noch unscharf ist
- Erstelle das PRD mit
bmad-prd - Ergänze UX-Arbeit, wenn das Feature nennenswerte Interface-Komplexität hat
- Erstelle die Architektur mit
bmad-create-architecture - Generiere Epics und Stories
- Führe die Prüfung der Implementierungsreife durch
- Geh in die Sprint-Planung und Implementierung über
Dieser Pfad gibt dem Coding-Agent bessere Constraints, eine bessere Zerlegung und weniger „halbes-Feature-neu-schreiben"-Überraschungen im Nachhinein.
8.2 Bestehendes Produkt mit einer kleinen Änderung
Erzwinge nicht die volle Methode.
Die offizielle Anleitung für etablierte Projekte empfiehlt bmad-quick-dev für kleinere Ergänzungen oder Aktualisierungen. Damit kannst du die Absicht klären, leicht planen, implementieren und in einer engeren Schleife reviewen.
8.3 Bestehendes Produkt mit einer großen Änderung
Setze BMAD bewusster ein:
- generiere oder verfeinere den Projektkontext
- richte die Planungs-Workflows auf deine echten Dokumente und Codebasis-Constraints aus
- stelle sicher, dass PRD und Architektur gegen das aktuelle System arbeiten und nicht gegen eine Greenfield-Fantasie
BMAD ist hier nützlich, weil bestehende Systeme meist an Integrationsannahmen scheitern, nicht an der Code-Generierung.
9. Wo BMAD übertrieben ist
BMAD ist wahrscheinlich zu viel, wenn:
- du einfach nur eine schnelle Coding-Schleife willst
- du deinen Basis-Agent noch lernst
- die Aufgabe ein einzelner Bugfix oder winziges Refactoring ist
- dein Projekt nicht von formalen Artefakten profitiert
- du es nicht magst, dich durch explizite Phasen zu arbeiten
Es kann auch kontraproduktiv werden, wenn du es performativ einsetzt, zum Beispiel:
- ein PRD generieren, das niemand lesen wird
- Architektur-Dokumente für triviale Änderungen schreiben
- mehrere Rollen aufrufen, wo ein einziger fokussierter Workflow genügt
BMAD kann schwache Teams organisiert wirken lassen, ohne die Entscheidungen tatsächlich zu verbessern. Die Methode hilft nur, wenn die erzeugten Artefakte besser sind als das, was du sonst tun würdest.
10. Web-Bundles und kostenbewusste Planung
Eine nützliche BMAD-Idee ist der Web-Bundle-Ansatz. Das Projekt verpackt ausgewählte Planungs-Workflows für Web-LLM-Oberflächen wie ChatGPT Custom GPTs und Gemini Gems.
Der praktische Grund ist clever:
- erledige umfangreiche Planungsarbeit in einem Flatrate-Web-Abo
- bring die ausgearbeiteten Artefakte danach in deine Coding-IDE
- gib gemessene IDE-Agent-Token für die Implementierung aus statt für ergebnisoffenes Ideenfinden
Das passt nicht zu jedem Team, aber es ist ein sinnvolles Muster, wenn die Planung lang ist und Implementierungs-Token teuer sind.
11. Eine realistische Einführungsstrategie
Wenn du die Vorteile willst, ohne in der Funktionsfülle zu ertrinken, nutze diese Reihenfolge:
Phase 1 - Lerne die Basis
- installiere das Kernmodul BMad Method
- führe
bmad-helpaus - probiere ein kleines, aber bedeutsames Feature
- halte den Ablauf auf PRD, Architektur und Implementierung begrenzt
Phase 2 - Passe es an deine echte Codebasis an
- generiere
project-context.md - prüfe, ob BMAD deine Konventionen tatsächlich besser respektiert
- entscheide, wann Quick Flow genügt und wann die volle Methode hilft
Phase 3 - Erweitere nur dort, wo es weh tut
- füge spezialisierte Module hinzu, wenn du sie wirklich brauchst
- nutze Web-Bundles, wenn die Planungskosten der Engpass sind
- passe erst dann an, wenn du das Standardverhalten verstanden hast
Diese Reihenfolge gibt dir Signal vor Zeremonie.
12. Fazit
BMAD passt gut zu Entwicklern und Teams, die bereits KI-Coding-Assistenten nutzen, aber eine wiederholbare Planungs- und Ausführungsmethode darum herum wollen. Es ist am wertvollsten, wenn die Arbeit mehrdeutig, funktionsübergreifend oder groß genug ist, dass Architektur und Zerlegung eine Rolle spielen.
Es ist nicht für jede Aufgabe die beste Wahl. Für kleine, offensichtliche Änderungen ist eine normale Coding-Agent-Schleife meist besser. Aber wenn das Problem größer als ein Prompt und kleiner als eine komplette menschliche Prozessabteilung ist, besetzt BMAD einen sehr nützlichen Mittelweg.