So funktioniert BMAD+

Diese Seite erklärt die Mechanik in einem Zug, für alle, die wissen möchten, was nach npx bmad-plus install passiert, bevor sie BMAD+ ein Projekt anvertrauen. BMAD+ ist kein Programm, das deine Agenten ausführt. Es ist eine Sammlung von Dateien (Anweisungen, Rollen, Workflows) plus ein kleines Kommandozeilenwerkzeug, das Aufzeichnungen führt. Dein KI-Coding-Tool, in diesen Seiten Host genannt, liest die Dateien und erledigt die Arbeit mit eigenem Modell und eigenen Berechtigungen.

Der Host führt aus#

Die Registry hält es als Vertrag fest: execution: host-managed, lifecycle_events: not-integrated. Praktisch heißt das vier Dinge. Der Host liefert das Modell, BMAD+ besitzt also keinen API-Schlüssel und ruft kein Modell auf. Der Host liefert die Berechtigungen: Eine Dateiänderung oder ein Shell-Befehl wird von deinem Tool erlaubt oder abgelehnt, nicht von BMAD+. Der Host liefert gegebenenfalls parallele Sub-Agenten. Und nichts läuft im Hintergrund: kein Daemon, kein Scheduler, keine Telemetrie.

Das Vokabular#

Was der Installer schreibt#

Die Installation kopiert Dateien in dein Projekt und hält fest, was sie kopiert hat. Sie rührt deinen Quellcode nicht an und startet nichts. Die einzige Schreibaktion außerhalb des Projekts ist das globale Brain des Memory-Packs in deinem Home-Verzeichnis (Zeile ~/.bmad-plus/brain/). Die Tabelle listet die Orte auf; die späteren Zeilen erscheinen nur, wenn du die jeweilige Funktion nutzt.

$ npx bmad-plus install --yes --lang en --packs core,design,memory --tools claude-code
●  Selected packs: ⚙️ Core, 🧠 Memory, 🎨 Design
●  Detected IDEs: Claude Code
●  🧠 Global brain created: /home/dev/.bmad-plus/brain
◇  ✅ 6 agents, 9 skills, 5 files copied
◇  ✅ 1 IDE(s) configured
└  BMAD+ is ready! Talk to Atlas to get started 🚀
$ npx bmad-plus doctor
│  98/98 checks passed
│  0 error(s), 0 warning(s)
│  Installed: v0.23.0 | Executing CLI: v0.23.0
│  Ownership inventory: complete
│  Integrations use host-managed execution; host capabilities were not probed.
# Auszug: Der Hilfekasten des Installers und die Leerzeilen wurden weggelassen, und das Home-Verzeichnis ist gekürzt. Die Zahlen hängen von den gewählten Packs ab. Die Brain-Zeile erscheint nur, wenn das Memory-Pack kein vorhandenes Brain findet.

Was wo läuft#

Von einem Satz zu Dateien#

1. 01

   Du schreibst an deinen Host

   Du sprichst einen Agent im Chat deines KI-Tools mit Namen an, in deiner Sprache.

   Im Terminal deines Projekts

   Atlas, help me define a small invoicing app for freelancers.

2. 02

   Der Host lädt die Anweisungen

   Der Host liest seine Adapter-Datei, die auf AGENTS.md verweist. Das Rückgrat nennt Atlas und den Ordner seiner SKILL.md. Das Lesen dieser Datei macht aus einem allgemeinen Assistenten die Persona.

3. 03

   Die Einstellungen werden gelesen, dann wartet Atlas

   Der Agent liest _bmad/config.yaml (deine Sprache, den Ausführungsmodus, das Verhalten der Checkpoints), begrüßt dich und zeigt sein Menü der Fähigkeiten (zum Beispiel CB für ein Produkt-Briefing, MR für eine Marktanalyse). Atlas wartet auf deine Wahl: eine Nummer, einen Code oder eine Formulierung, die zu einem davon passt.

4. 04

   Eine Rolle wird gewählt

   Atlas hat zwei Rollen, Analyst (Recherche, Discovery) und Product Manager (Planung, Produkt-Briefings, PRD). Ein Stichwort wie „market“ oder „PRD“ oder eine Situation wie ein neues Projekt lässt die Rolle wechseln, und der Agent sagt es. Der Ausführungsmodus und die Checkpoints entscheiden danach, ob er anhält und fragt oder weitermacht.

5. 05

   Ein Ergebnis wird geschrieben

   Nach deiner Wahl, zum Beispiel CB, um ein Produkt-Briefing zu erstellen, schreibt der Host das Ergebnis mit seinen eigenen Berechtigungen ins Projekt, normalerweise in den Ausgabeordner (standardmäßig _bmad-output/). Du prüfst es wie jede andere Datei.

6. 06

   Die CLI führt bei Bedarf Buch

   Für Intake, Schwärme, Reviews oder Abnahmen ruft der Agent bmad-plus auf, um Belege zu prüfen, zu zählen oder zu versiegeln. Die CLI antwortet mit Dateien und Exit-Codes, nie mit Meinungen.

Wie Rollen wechseln#

Die Regeln stehen in .agents/data/role-triggers.yaml. Jeder Agent kann auf drei Ebenen die Rolle wechseln und kündigt den Wechsel an, damit du ihn ablehnen kannst.

Die Ankündigung lautet etwa „I’m switching to QA mode - financial calculations detected. Say ’skip’ to stay in current mode.“ Mit auto_role_activation: false in _bmad/config.yaml schaltest du den automatischen Wechsel aus; eine Rolle kannst du weiterhin namentlich anfordern.

Einstellungen und Ausführungsmodi#

Der Installer schreibt _bmad/config.yaml einmal und behält deine Änderungen bei späteren Installationen. execution_mode ist standardmäßig manual: Du rufst jeden Agent selbst auf. autopilot lässt Nexus die ganze Pipeline abarbeiten; hybrid ist Autopilot mit häufigen Checkpoints. Jeder Checkpoint (discovery, architecture, story, delivery) ist require_approval, notify_only oder auto.

execution_mode: 'manual'
auto_role_activation: true
parallel_execution: true
checkpoints:
  discovery: 'require_approval'
  architecture: 'require_approval'
  story: 'require_approval'
  delivery: 'require_approval'
uat:
  mode: 'advisory'
swarm:
  budget: 26
  wave: 10
  media_credits: 'ask'

Generierte Dateien und deine Änderungen#

Das Rückgrat und die Adapter werden aus registry.yaml im BMAD+-Quell-Repository generiert, sodass Zahlen und Listen nicht von den Deklarationen abweichen können. In deinem Projekt kannst du einem Adapter trotzdem eigene Regeln hinzufügen. Der Installer hält für jede geschriebene Datei einen SHA-256-Hash fest; ein Adapter oder Skill, dessen Hash nicht mehr passt, gilt als deiner und bleibt bei Updates und beim Deinstallieren erhalten.

Was BMAD+ bewusst nicht tut#

• Keine Modell-Laufzeit: Es ruft keine LLM-API auf, hält keinen Schlüssel dafür und führt keine eigene Agent-Schleife aus.
• Kein Hintergrundprozess: kein Daemon, kein Scheduler, kein Telemetrie-Exporter, kein stilles Selbst-Update.
• Keine Review-Engine, die rät: Befunde, die der Code nicht verankern kann, werden als solche gemeldet und nie von einem Modell verschoben.
• Keine automatische Korrektur aus einem Review: Ein Review gewährt keine Schreibrechte, und die menschliche Abnahme bleibt das Freigabetor.
• Keine IDE-Erweiterung und kein Posten auf GitHub, GitLab oder anderen Forges.