BMAD+ · Dokumentation
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.
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.
Öffne ein Terminal im Repository, an dem du arbeiten möchtest, und prüfe die Node.js-Version. Nutze weiterhin deine übliche Versionsverwaltung.
node --versionDie Ausgabe sollte v20 oder neuer anzeigen. Installiere oder aktualisiere Node.js bei Bedarf separat.
Starte das Installationsprogramm. Wähle die Adapter deiner KI-Werkzeuge und die benötigten Packs. Core enthält Atlas, Forge, Sentinel und Nexus.
npx [email protected] installDie Installation erstellt Agentenanweisungen, die gemeinsame Projektbasis und die gewählten Adapter. Optionale Packs können weitere Laufzeitumgebungen oder API-Zugänge benötigen.
Ö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.
bmad-helpNach der Installation ist kein weiterer BMAD+-Initialisierungsbefehl nötig. bmad-help ist eine Nachricht an den Assistenten, kein Terminalbefehl.
Beschreibe Ziel, Einschränkungen und erwartetes Ergebnis. Beginne bei einer neuen Idee mit Atlas, bei einer Änderung am bestehenden Code mit Forge.
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.
Bitte Sentinel, die Änderung anhand der Akzeptanzkriterien zu prüfen. Fordere Testergebnisse und eine kurze Übergabe für die nächste Sitzung an.
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.Lies die Änderungen und Testergebnisse. Der Assistent arbeitet innerhalb der Rechte und Fähigkeiten seines Host-Werkzeugs.
Ersetze die Projektdetails durch deine eigenen. Diese Gesprächseinstiege nennen ein konkretes Ergebnis zur Prüfung.
Nutze dies, nachdem du Nutzer und Problem beschrieben hast.
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.
Ergänze das beobachtete Verhalten, Schritte zur Reproduktion und relevante Fehlermeldungen.
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.
Nutze dies, wenn dein Host parallele Agenten unterstützt und die Aufgaben nicht dieselben Dateien bearbeiten.
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.
Nutze dies zu Beginn einer späteren Sitzung im selben Projekt.
Lies AGENTS.md und die verfügbare Projekterinnerung. Fasse den letzten geprüften Stand, offene Entscheidungen und die nächste unerledigte Aufgabe zusammen. 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.
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.
Vergleiche die installierte Version mit npm. Das Ergebnis enthält installedVersion, latestVersion, status, updateAvailable und canAutoApply.
npx --no-install bmad-plus update-check --refresh --jsonDieser 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.
npx [email protected] update-check --refresh --jsonDieser Befehl fragt npm erneut ab und bittet um Bestätigung der genauen Zielversion. Lies den Bericht einschließlich der beibehaltenen angepassten Dateien.
npx --no-install bmad-plus update --latestNutze einmalig die CLI mit expliziter Version. Diese bestätigte Migration sichert ersetzte Dateien, weil ältere Installationen keine vollständigen Eigentums-Hashes besitzen.
npx --yes [email protected] update --yesAktiviere 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.
npx --no-install bmad-plus update-policy --mode auto --range "^0.13.0"npx --no-install bmad-plus update-policy --mode notifyUpdate-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.
npx --no-install bmad-plus update --restore RECEIPT_ID --yesDie neueste veröffentlichte Version berücksichtigt lokale Änderungen bei Updates. Anleitung und Installationsbefehl beziehen sich auf dieselbe Version.
v0.13.0 ·
Entdecke veröffentlichte Versionen, steuere automatische Updates und erhalte angepasste Agentendateien.
VersionsverlaufAusgewählte aktuelle Versionen mit ihrem tatsächlichen Veröffentlichungsdatum auf npm. Die Zusammenfassungen beschreiben ausgelieferte Änderungen. Die Paketseite bietet den vollständigen Versionsverlauf.
v0.13.0 ·
Entdecke veröffentlichte Versionen, steuere automatische Updates und erhalte angepasste Agentendateien.
v0.12.2 ·
Das SEO-Pack enthält die Python-Skripte und Abhängigkeiten für seinen dokumentierten Workflow.
v0.12.1 ·
Die Projekterinnerung erkennt ein vorhandenes gemeinsames Gedächtnis besser und hält die gewählte Verknüpfung fest.
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.
Nein. bmad-help, autopilot und parallel sind Gesprächsanweisungen für deinen KI-Assistenten. Terminalbefehle verwenden die BMAD+-CLI, wie in den Beispielen oben.
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.