bmad+
Menü
DESprache wählen
Loslegen

BMAD+ · Dokumentation

BMAD+ Dokumentation

Was BMAD+ ist, was jedes Pack und jeder Agent tut, alle Befehle und Dateien sowie Anleitungen Schritt für Schritt. Beginne mit der Kurzanleitung unten oder wähle ein Thema.

Veröffentlichte Version v0.23.1Dokumentation geprüft

Anleitung starten Neuigkeiten

Nach Thema stöbern

Alle Seiten

Konzepte

Packs

Agenten

Referenz

Anleitungen

Sicherheit und Daten

Fragen und Lösungen

Häufige Aufgaben

Von der Installation zum ersten Workflow.

Beginne mit einer kleinen Aufgabe in deinem Projekt. Diese Anleitung zeigt, was du im Terminal ausführst, was du deinen KI-Assistenten fragst und wie du BMAD+ aktuell hältst.

Schritt für Schritt starten

Du brauchst Node.js 20 oder neuer und dein gewohntes KI-Entwicklungswerkzeug. BMAD+ liefert Projektanweisungen, Rollen und Workflows; dein Werkzeug stellt das Modell und die Ausführungsrechte bereit.

  1. Projektordner öffnen

    Öffne ein Terminal im Repository, an dem du arbeiten möchtest, und prüfe die Node.js-Version. Nutze weiterhin deine übliche Versionsverwaltung.

    Im Terminal deines Projekts
    node --version

    Die Ausgabe sollte v20 oder neuer anzeigen. Installiere oder aktualisiere Node.js bei Bedarf separat.

  2. BMAD+ installieren und Werkzeuge wählen

    Starte das Installationsprogramm. Wähle die Adapter deiner KI-Werkzeuge und die benötigten Packs. Core enthält Atlas, Forge, Sentinel und Nexus.

    Im Terminal deines Projekts
    npx bmad-plus@0.23.1 install

    Die Installation erstellt Agentenanweisungen, die gemeinsame Projektbasis und die gewählten Adapter. Optionale Packs können weitere Laufzeitumgebungen oder API-Zugänge benötigen.

  3. Sitzung im selben Ordner starten

    Öffne oder starte deinen KI-Coding-Assistenten im Projekt neu, damit er seinen Adapter und AGENTS.md laden kann. Frage nach den installierten Agenten und Workflows.

    In deinem KI-Assistenten
    bmad-help

    Nach der Installation ist kein weiterer BMAD+-Initialisierungsbefehl nötig. bmad-help ist eine Nachricht an den Assistenten, kein Terminalbefehl.

  4. Einer Rolle eine konkrete Aufgabe geben

    Beschreibe Ziel, Einschränkungen und erwartetes Ergebnis. Beginne bei einer neuen Idee mit Atlas, bei einer Änderung am bestehenden Code mit Forge.

    In deinem KI-Assistenten
    Atlas, hilf mir, eine kleine Rechnungsanwendung für Selbstständige einzugrenzen. Frage nach den Nutzern, bestimme den ersten nützlichen Ablauf und schreibe ein Briefing mit Akzeptanzkriterien.

    Prüfe das Briefing, bevor du Forge eine Story umsetzen lässt. Ein klares Ergebnis macht Fortschritte überprüfbar.

  5. Ergebnis prüfen und Kontext sichern

    Bitte Sentinel, die Änderung anhand der Akzeptanzkriterien zu prüfen. Fordere Testergebnisse und eine kurze Übergabe für die nächste Sitzung an.

    In deinem KI-Assistenten
    Sentinel, prüfe diese Änderung anhand der Akzeptanzkriterien. Überprüfe die wichtigsten Erfolgs- und Fehlerfälle, nenne offene Probleme und fasse zusammen, was die nächste Sitzung wissen muss. Wenn das BMAD+ CLI verfügbar ist, versiegle den Umfang mit bmad-plus review scope, wende die Regeln seiner Checkliste an, zitiere den Code jedes Befunds, belege jede ausgewählte Datei und berichte, was bmad-plus review gate antwortet.

    Lies die Änderungen und Testergebnisse. Der Assistent arbeitet innerhalb der Rechte und Fähigkeiten seines Host-Werkzeugs.

Beispiele zum Anpassen

Ersetze die Projektdetails durch deine eigenen. Diese Gesprächseinstiege nennen ein konkretes Ergebnis zur Prüfung.

Von einer Idee zur ersten Version

Nutze dies, nachdem du Nutzer und Problem beschrieben hast.

In deinem KI-Assistenten
Nexus, plane die erste nutzbare Version meiner Terminbuchungs-App. Lass Atlas den Umfang eingrenzen, Forge die kleinste Umsetzung vorschlagen und Sentinel Akzeptanzprüfungen definieren. Liste Abhängigkeiten auf und halte vor der Umsetzung zur Planprüfung an.

Erwartetes Ergebnis: ein priorisierter Plan, eine kleine erste Story und klare Prüfpunkte.

Einen Fehler im bestehenden Projekt beheben

Ergänze das beobachtete Verhalten, Schritte zur Reproduktion und relevante Fehlermeldungen.

In deinem KI-Assistenten
Forge, untersuche, warum das Speichern einer bearbeiteten Rechnung ein Duplikat erzeugt. Reproduziere den Fehler, finde die Ursache und schlage die kleinste Korrektur vor. Ergänze eine Regressionsprüfung für den tatsächlichen Fehler und bitte Sentinel, den betroffenen Ablauf zu prüfen.

Erwartetes Ergebnis: ein reproduzierter Fehler, eine gezielte Korrektur und ein Nachweis der Regressionsabdeckung.

Einen Bildschirm mit Atelier gestalten

Nutze dies mit dem optionalen Design-Pack. Atelier stellt zuerst seine Fragen und folgt dann prüfbaren Regeln.

In deinem KI-Assistenten
Atelier, führe die Design-Analyse für die Rechnungsliste meiner App durch, baue den Bildschirm und schließe mit dem Preflight-Urteil ab.

Erwartetes Ergebnis: die festgehaltene Design-Analyse, der Bildschirm mit allen abgedeckten Zuständen und das Preflight-Urteil als letzte Zeile.

Ohne verlorene Entscheidungen fortsetzen

Nutze dies zu Beginn einer späteren Sitzung im selben Projekt; ein optionales Pack ist nicht erforderlich.

In deinem KI-Assistenten
Lies AGENTS.md und die verfügbare Projekterinnerung. Fasse den letzten geprüften Stand, offene Entscheidungen und die nächste unerledigte Aufgabe zusammen. Unterscheide veröffentlichte Funktionen von lokalen Kandidaten und automatisierte Prüfungen von menschlicher Abnahme. Prüfe vor dem Fortsetzen, ob die Notizen noch zum Code passen.

Erwartetes Ergebnis: ein kurzer, belegter Wiedereinstieg. Projektnotizen liefern Kontext und müssen mit dem aktuellen Stand abgeglichen werden.

Fortgeschrittene Beispiele: Koordination, Abnahme und Gedächtnis

Unabhängige Arbeit koordinieren

Nutze dies, wenn dein Host parallele Agenten unterstützt und die Aufgaben nicht dieselben Dateien bearbeiten.

In deinem KI-Assistenten
Nexus, teile die freigegebene Arbeit in unabhängige Aufgaben auf. Gib jeder Rolle einen Umfang, zugeordnete Dateien und klare Abschlusskriterien. Nutze parallele Agenten nur, wenn dieses Werkzeug sie unterstützt; führe die Aufgaben sonst nacheinander aus. Integriere die Ergebnisse und lass Sentinel den gesamten Nutzerablauf prüfen.

Erwartetes Ergebnis: begrenzte Aufträge, klare Abhängigkeiten und eine gemeinsame Abschlussprüfung. Parallele Ausführung kommt vom Host-Werkzeug.

Eine Lieferung von einer Person bestätigen lassen

Verwenden Sie dies, wenn eine Version auf Ihrer Testumgebung ankommt und jemand sie am Bildschirm prüfen muss.

In deinem KI-Assistenten
Sentinel, schreibe das Abnahmerezept für diese Lieferung auf unserer Testumgebung. Ein Schritt je Handgriff, eine überprüfbare Tatsache je Zeile, Bildschirmtexte aus dem Code zitiert, und markiere die wirklich schreibenden Schritte. Baue die Seite und nenne mir Link, Dauer und was ich nicht überspringen darf. Verwende möglichst wegwerfbare Testdaten, benenne den Ordner und die Dateien, die jeder Befehl ändert, und halte automatisierte Nachweise von den Antworten der Person getrennt. Bevor du mir die Seite übergibst, baue sie mit uat build, prüfe die aufgelisteten Garantien, spiele den wesentlichen Durchgang selbst in einem echten Browser — starten, ankreuzen, eine Bemerkung tippen, neu laden, alles ist wieder da — und sage mir, welche Prüfungen liefen.

Erwartetes Ergebnis: eine Seite, die auch eine nicht technische Person durchgehen kann, und ein Durchlauf, den der Agent zurückliest, um jeden Fehlschlag einzuordnen, bevor etwas korrigiert wird.

Eine Sitzung mit Zecher sichern

Nutze dies vor dem Ende einer Sitzung, wenn das optionale Memory-Pack installiert ist.

In deinem KI-Assistenten
Zecher, aktualisiere den Projektspeicher anhand der tatsächlich abgeschlossenen Änderungen und Prüfungen. Unterscheide implementierte, getestete, veröffentlichte und noch offene Arbeit. Halte Entscheidungen und hilfreiche Belege fest, archiviere ersetzte Notizen ohne sie zu löschen und schreibe einen kurzen Prompt für die nächste Sitzung. Halte den Speicher in diesem Projekt und lasse Geheimnisse weg.

Erwartetes Ergebnis: ein knapper aktueller Kontext, eine datierte Sitzungsübergabe und ein Prompt zum Fortsetzen mit der nächsten offenen Aufgabe.

Einen Durchlauf ohne Vermutungen prüfen

Nutze dies, wenn eine Person einen Abnahmedurchlauf beendet oder unterbrochen hat.

In deinem KI-Assistenten
Sentinel, lies den neuesten Abnahmedurchlauf und vergleiche seinen Fingerabdruck mit dem aktuellen Rezept. Frage nach den tatsächlich ausgeführten Schritten, wenn Antworten und Nachweise widersprüchlich sind. Ordne Fehler vor Änderungsvorschlägen ein, prüfe Schreibschritte nur lesend und unterscheide menschliche Beobachtungen, automatisierte Prüfungen und ausdrücklich übernommene Risiken mit benannter verantwortlicher Person. Bestätige niemals einen nicht ausgeführten Schritt.

Erwartetes Ergebnis: ein klares Urteil, Nachweise für bestätigte Schreibvorgänge und eine kurze Liste noch offener Prüfungen.

Updates prüfen und anwenden

Führe diese Befehle im installierten Projekt aus. Die Prüfungen verwenden eine bereits verfügbare CLI. Findet npx --no-install sie nicht, nutze den unten gezeigten Befehl mit expliziter Version.

Veröffentlichte Version prüfen

Vergleiche die installierte Version mit npm. Das Ergebnis enthält installedVersion, latestVersion, status, updateAvailable und canAutoApply.

Im Terminal deines Projekts
npx --no-install bmad-plus update-check --refresh --json

Wenn die CLI fehlt oder die Installation älter ist

Dieser explizite Befehl lädt die dokumentierte CLI und prüft dein Projekt. Nutze bei Version 0.12.2 oder älter die Migration im nächsten Absatz, um die Update-Erkennung hinzuzufügen.

Im Terminal deines Projekts
npx bmad-plus@0.23.1 update-check --refresh --json

Ein verfügbares Update prüfen und anwenden

Dieser Befehl fragt npm erneut ab und bittet um Bestätigung der genauen Zielversion. Lies den Bericht einschließlich der beibehaltenen angepassten Dateien.

Im Terminal deines Projekts
npx --no-install bmad-plus update --latest

  • Benachrichtigung ist der Standard. Eine Versionsprüfung aktiviert keine automatischen Updates. Offline, veraltete oder nicht verfügbare Ergebnisse bedeuten, dass die neueste Version unbekannt ist.
  • Updates erhalten erkannte Anpassungen. Der Bericht kann eine teilweise Anwendung melden, wenn lokale Dateien erhalten bleiben; die installierte Versionsnummer beweist nicht, dass jede Datei der Veröffentlichung entspricht.
  • Bitte den Assistenten nach einem erfolgreichen Update, AGENTS.md und die relevanten Skills erneut zu lesen, oder beginne eine neue Sitzung.
  • BMAD+-Paketupdates und die Synchronisierung des BMAD-METHOD-Quellcodes sind getrennte Aufgaben. Diese Befehle aktualisieren BMAD+; sie führen keinen Upstream-Quellcode in deinem Projekt zusammen.
Fortgeschritten: Migration, Update-Verhalten und automatische Richtlinie

Von Version 0.12.2 oder älter migrieren

Nutze einmalig die CLI mit expliziter Version. Diese bestätigte Migration sichert ersetzte Dateien, weil ältere Installationen keine vollständigen Eigentums-Hashes besitzen.

Im Terminal deines Projekts
npx --yes bmad-plus@0.23.1 update --yes

Optional: automatische Updates auf einen Bereich begrenzen

Aktiviere dies nur, wenn das Projekt zulässige Versionen im angegebenen Semver-Bereich anwenden soll. Die CLI prüft weiterhin Laufzeitkompatibilität, Dateieigentum und Richtlinie. Mit notify kehrst du zu Benachrichtigungen zurück.

Im Terminal deines Projekts
npx --no-install bmad-plus update-policy --mode auto --range "^0.23.1"

Im Terminal deines Projekts
npx --no-install bmad-plus update-policy --mode notify

Nach einem Update wiederherstellen

Update-Belege und Sicherungen liegen unter .bmad/updates/. Ersetze RECEIPT_ID durch die tatsächliche Belegkennung. Die Wiederherstellung prüft die Sicherungen und verweigert das Überschreiben späterer lokaler Änderungen.

Im Terminal deines Projekts
npx --no-install bmad-plus update --restore RECEIPT_ID --yes

Neuigkeiten

Diese Hinweise beschreiben die auf npm verifizierte Version. Anleitung, Installationsbefehl und Versionsfeed beziehen sich auf dieselbe Veröffentlichung.

v0.23.1 ·

Die Dokumentationsseite ist in vier Sprachen neu aufgebaut, mit sieben Videos. Mehrere Befehle verhalten sich jetzt genau so, wie ihre Seiten es sagen: Ablehnungen lauten überall gleich, ein Review des Arbeitsbaums beginnt bei HEAD, und die Konfigurationsdatei ist schlichtes YAML. Installation und Update bleiben wie bisher.

Versionsverlauf

Versionsverlauf

Ausgewählte aktuelle Versionen mit ihrem tatsächlichen Veröffentlichungsdatum auf npm. Die Zusammenfassungen beschreiben ausgelieferte Änderungen. Die Paketseite bietet den vollständigen Versionsverlauf.

v0.23.1 ·

Eine ehrlichere Seite, verlässlichere Befehle

Die Dokumentationsseite ist in vier Sprachen neu aufgebaut, mit sieben Videos. Mehrere Befehle verhalten sich jetzt genau so, wie ihre Seiten es sagen: Ablehnungen lauten überall gleich, ein Review des Arbeitsbaums beginnt bei HEAD, und die Konfigurationsdatei ist schlichtes YAML. Installation und Update bleiben wie bisher.

  • Die Website hat jetzt 52 Dokumentationsseiten, jede auf Englisch, Französisch, Spanisch und Deutsch, eine neu gebaute Landing-Seite und sieben Präsentationsvideos mit Untertiteln und beschriebenen Transkripten, darunter eine Fallstudie dazu, wie die Website selbst mit einem Schwarm von Agenten neu gebaut wurde.
  • Ein --auto-Update, das die Richtlinie nicht erlaubt, wird überall mit derselben Meldung abgelehnt: Update refused: automatic-updates-not-authorized. Die Ablehnungen wegen eines alten Eigentumsinventars und wegen lokaler Konflikte verwenden dieselbe Form Update refused:.
  • bmad-plus review scope --workspace beginnt bei HEAD, wenn du kein --base angibst; ein Review nicht eingecheckter Arbeit scheitert damit nicht mehr und zieht den letzten Commit nicht mehr mit.
  • _bmad/config.yaml wird als schlichtes YAML geschrieben (auto_role_activation: true, nicht als getaggtes !!bool 'true'), egal welche unterstützte js-yaml-Version es schreibt.
  • Die erzeugten Anweisungsdateien sagen, die Versionsprüfung ohne Erwähnung zu überspringen, wenn npx keine lokale Kopie von bmad-plus findet; Nexus-Fehler tragen das Präfix Nexus: einmal statt zweimal.
  • Shield nennt überall PCI DSS v4.0.1, die Swarm-Skills nennen drei Arten, die Bash-Variante des Backup-Packs zeigt die Archivgröße wie die PowerShell-Variante, und npm-Beschreibung, Schlüsselwörter und README-Credits sind aktualisiert.
Veröffentlichtes Paket · v0.23.1

v0.23.0 ·

Erst fragen, dann schwärmen

Ein Pack erklärt jetzt, welche Fragen beantwortet sein müssen, bevor es handelt, und Nexus kann einen Schwarm von Unteragenten, ein simuliertes Panel oder eine Jury innerhalb eines von dir gesetzten Budgets ausführen. Atelier, die Design-Engine, kommt als zehntes Pack hinzu. Installation und Update bleiben wie bisher.

  • bmad-plus intake stellt die Fragen eines Packs in kleinen Gruppen, markiert die Pflichtangaben, schlägt Standardwerte vor, hält fest, was du nicht weißt, samt Risiko, und erzeugt das Briefing, das zum Vertrag für alles Weitere wird. Nichts darin wird erfunden.
  • bmad-plus swarm zieht simulierte Einheiten aus einem Profil mit einem Seed, schreibt ein Briefing pro Unteragent, prüft jede Antwortdatei, zählt nur gültige Antworten und sagt klar, dass simulierte Käufer keine Kunden sind. Der Block swarm in _bmad/config.yaml legt fest, wie viele Unteragenten laufen, bevor der Assistent dich fragt; bezahlte Mediengenerierung fragt immer.
  • Die Registry hält jetzt fest, welche Skills ein Agent führt, aus welchem npm-Paket die Skills eines Packs stammen, welche Pipeline-Schritte und Freigaben ein Pack erklärt und welches Briefing es durchführt. Die erzeugten Anweisungen tragen all das, nichts wird zweimal getippt.
  • Design-Pack: Atelier, gebaut aus dem Paket design-skill, befragt dich mit einer Design-Analyse und baut, prüft oder überarbeitet dann eine Oberfläche nach prüfbaren Regeln. Der Installer kopiert seine drei Skills mit ihren Referenzmodulen, und doctor prüft sie.
  • Ein Trigger-Gate lehnt Regeln zur automatischen Aktivierung ab, die einen der Registry unbekannten Agenten oder eine unbekannte Pipeline nennen, und der Installer schreibt nichts, wenn sich die Dateien eines Packs nicht vorher vollständig auflisten lassen.
Veröffentlichtes Paket · v0.23.0

v0.22.0 ·

Was deinen Rechner verlässt, erklärt und geprüft

BMAD+ erklärt jetzt jede Datenübertragung und jeden Prozess, den es startet, und seine CI lehnt alles Unerklärte ab. Die Abnahmeseite und der SEO-Bericht laden nichts mehr von anderen Websites, OSINT-Aufrufe laufen nur über HTTPS, und Shield erhält einen Sicherheitsnachweis aus ausgeführten Prüfungen und ein Verzeichnis der KI-Verarbeitungen. An Installation und Update ändert sich nichts.

  • Die Registry gibt an, was BMAD+ sendet, an wen, wann und mit welcher Einwilligung; SECURITY.md zeigt es, und die installierten Agentenanweisungen fassen es zusammen. Eine Build-Prüfung schlägt fehl, wenn ein Netzwerkaufruf oder ein gestarteter Prozess nicht erklärt ist. BMAD+ hat keine Telemetrie, und die Update-Prüfung lässt sich abschalten.
  • Die Abnahmeseite lädt weder Google Fonts noch sonst etwas von einer anderen Website: Wer sie öffnet, verrät das niemandem. Der Build lehnt eine Seite ab, die es täte, und ein echter Browser prüft jede Anfrage eines Durchlaufs. Auch der HTML-SEO-Bericht öffnet sich offline.
  • Der Google-API-Schlüssel des SEO-Packs wird in einem Anfrage-Header übertragen, nie in einer URL, und erscheint in keiner Fehlermeldung. OSINT-Anbieteraufrufe lehnen alles außer HTTPS ab und folgen nie einer Weiterleitung zu einem anderen Host.
  • SEO-Screenshots erreichen nur die geprüfte Adresse: Chromium löst nichts anderes auf, und Weiterleitungen oder Ressourcen, die woanders hinzeigen, werden blockiert und aufgelistet.
  • Shield: bmad-plus assurance erstellt einen Sicherheitsnachweis, dessen Belege nur tatsächlich ausgeführte Prüfungen sein können, festgehalten in einem manipulationssicheren Protokoll; bmad-plus ai-register führt das Verzeichnis der KI-Werkzeuge eines Projekts und warnt vor nicht erfassten; sechs Review-Regeln nennen die Compliance-Kontrollen, die eine Änderung berührt.
  • Der MCP-Server schließt SSE-Streams sauber, wenn ein Client geht oder der Server stoppt, und akzeptiert Token-Daten mit Zeitzonenversatz.
Veröffentlichtes Paket · v0.22.0
Alle veröffentlichten Versionen auf npm

Bei offenen Fragen

Mein Assistent sieht die Agenten nicht. Was soll ich prüfen?

Prüfe, ob er im installierten Projekt geöffnet ist, sein Adapter ausgewählt wurde und AGENTS.md sowie .agents/skills/ vorhanden sind. Starte eine neue Sitzung und bitte ihn, die Anweisungen zu lesen. Jeder Host hat eigene Laderegeln.

Gebe ich autopilot oder parallel im Terminal ein?

Nein. bmad-help, autopilot und parallel sind Gesprächsanweisungen für deinen KI-Assistenten. Terminalbefehle verwenden die BMAD+-CLI, wie in den Beispielen oben.

Die Prüfung meldet unknown oder offline. Bin ich aktuell?

Dieses Ergebnis belegt nicht die neueste veröffentlichte Version. Arbeite weiter und wiederhole die Prüfung, wenn die Registry erreichbar ist. Eine nicht verfügbare Prüfung erlaubt keine Änderung der Update-Richtlinie.

Nach oben