Ein Einsteigerpfad vom leeren Terminal zum geprüften ersten Ergebnis: installieren, prüfen, mit dem ersten Agent sprechen, prüfen, Kontext bewahren, aktuell bleiben. Jeder Schritt mit echtem Befehl.
Diese Seite führt dich von null zu einem ersten Ergebnis, das du selbst geprüft hast, in einer Reihenfolge, die funktioniert. Du brauchst einen Projektordner, Node.js 20 oder neuer und ein KI-Coding-Tool, das du schon nutzt (Claude Code, Gemini CLI, Cursor, Codex CLI und andere). BMAD+ liefert Anweisungen, Rollen und Workflows; dein Tool liefert das Modell und die Berechtigungen, Dateien zu ändern und Befehle auszuführen. Nichts davon braucht ein BMAD+-Konto, einen eigenen API-Schlüssel oder einen Hintergrunddienst.
BMAD+ im ÜberblickWas BMAD+ installiert, wie ein Pack vor dem Handeln fragt, wie ein Schwarm ehrlich ausgewertet wird und welche zehn Packs es gibt.Transkript
BMAD+ installiert Rollen, Workflows und gemeinsamen Kontext in das KI-Coding-Werkzeug, das du bereits nutzt. Es beginnt mit Fragen: Ein Pack legt fest, was beantwortet sein muss, bevor es handelt. Du beantwortest jeweils ein paar, und was du nicht weißt, wird als unbekannt mit seinem Risiko festgehalten. Danach kann Nexus einen Schwarm von Sub-Agenten starten, innerhalb eines Budgets, das du festlegst. Jeder liest ein Briefing und schreibt eine Antwort, und nur gültige Antworten werden gezählt. Die gezeigte Auswertung beruht auf Demodaten und sagt offen: Simulierte Einheiten sind keine Menschen. Bei geplanter Arbeit verlangt Nexus unabhängige Prüfungen, bevor es ein Ergebnis akzeptiert. Vier Core-Rollen, neun optionale Packs und Adapter für sieben KI-Coding-Werkzeuge. Installiert wird mit einem einzigen npx-Befehl im Projektordner.
Befehle, die mit npx bmad-plus beginnen, gehören ins Terminal. Sätze wie bmad-help, autopilot, parallel oder „Atlas, ...“ gehören in den Chat deines KI-Tools. autopilot im Terminal einzutippen bringt nichts.
Nimm das Repository, an dem du arbeiten willst. Der Befehl sollte v20 oder höher ausgeben; installiere oder aktualisiere sonst Node.js separat.
Im Terminal deines Projekts
node --version
02
Starte den Installer
Der interaktive Assistent fragt nach Sprache, Packs, Tools (falls keines erkannt wird), deinem Namen, deiner Kommunikationssprache, einer Test-URL für Abnahmeprotokolle (optional) und dem Ausführungsmodus. Core wird immer installiert. Tools werden an Ordnern wie .claude/ oder .cursor/ erkannt.
Im Terminal deines Projekts
npx bmad-plus@0.23.1 install
03
Oder installiere ohne Fragen
Für ein Skript oder einen ersten Versuch gibst du alles auf der Kommandozeile an. --yes überspringt den Assistenten (standardmäßig Englisch, sofern du kein --lang angibst); --tools nimmt IDs wie claude-code, gemini-cli, antigravity, cursor, codex-cli, opencode, aider oder all bzw. none.
Der Installer endet mit einer kurzen Anleitung, mit wem du sprichst, und einer Zeile wie „BMAD+ is ready! Talk to Atlas to get started“. Bei einer unbekannten Pack- oder Tool-ID stoppt er und gibt die gültigen IDs aus; ohne Terminal und ohne --yes weigert er sich zu laufen.
Was die Installation in einem Git-Projekt hinterlässt
$ npx bmad-plus install --yes --lang en --packs core --tools claude-code$ git status --short?? .agents/?? AGENTS.md?? CLAUDE.md?? _bmad/$ ls .agents/skillsagent-architect-devagent-orchestratoragent-qualityagent-strategistbmad-plus-autopilotbmad-plus-intakebmad-plus-parallelbmad-plus-swarmbmad-plus-syncbmad-plus-uat# Vier neue Pfade, nichts in deinem Quellbaum. Entscheide mit deinem Team, ob ihr sie committet oder ignoriert; in beiden Fällen hält `_bmad/.bmad-plus-install.json` fest, welche Dateien BMAD+ gehören.
npx bmad-plus install --yes --lang en --packs core --tools claude-code
git status --short
ls .agents/skills
Ausgabe eines echten Laufs. Quelle: Auf einem Testserver am 2026-10-18 mit dem Quellcode 0.23.0 (tools/cli/bmad-plus-cli.js) in einem Wegwerf-Git-Projekt nachgespielt
Der Installer legt bmad-plus nicht im node_modules deines Projekts ab, und die ab hier verwendeten npx --no-install-Befehle starten nur eine lokale Kopie: Ohne sie brechen sie mit npx canceled due to missing packages and no YES option ab. Das fügt der package.json eine Dev-Abhängigkeit hinzu. Überspring den Schritt, wenn du lieber npx bmad-plus <command> tippst, das das Paket bei Bedarf lädt. Ohne lokale Kopie wird die Update-Prüfung, die die erzeugten CLAUDE.md und AGENTS.md deinen Assistenten ausführen lassen, einfach übersprungen.
Im Terminal deines Projekts
npm install --save-dev bmad-plus
02
Starte die Gesundheitsprüfung
doctor ist schreibgeschützt: Es ändert nie das Projekt und kontaktiert nie npm. Es endet mit einer Zeile wie „98/98 checks passed“ und „0 error(s)“ und endet mit 1, wenn es einen Fehler gibt.
Im Terminal deines Projekts
npx --no-install bmad-plus doctor
03
Öffne dein KI-Tool im selben Ordner
Starte eine neue Sitzung (oder starte das Tool neu), damit es seine Adapter-Datei und AGENTS.md lädt. Es gibt keinen zusätzlichen BMAD+-Initialisierungsbefehl.
04
Frag ihn, was er weiß
Im Chat, nicht im Terminal. Wenn er Atlas, Forge, Sentinel und Nexus aufzählt, hat dein Tool die Anweisungen gelesen. Falls nicht, prüfe, dass das Tool im installierten Projekt geöffnet ist, dass du seinen Adapter gewählt hast und dass AGENTS.md und .agents/skills/ existieren.
Wähle die kleinste echte Sache, die du brauchst. Die vier Core-Agenten decken die meisten Anfänge ab: Atlas für Ideen und Anforderungen, Forge für Architektur und Code, Sentinel für Review und Tests, Nexus für Pläne und Koordination. Ein guter Prompt nennt das Ziel, die Randbedingungen und das Ergebnis, das du prüfen willst.
Nutze es, wenn es noch keinen Code gibt oder du das Problem aufschreiben willst, bevor du etwas änderst.
In deinem KI-Assistenten
Atlas, ich möchte ein kleines Werkzeug, mit dem unser Support-Team eingehende Tickets sortiert. Frag mich nach den Nutzern und ihrem Tagesablauf und schreibe dann einen Product Brief mit dem ersten nützlichen Ablauf und Abnahmekriterien, die ich prüfen kann. Höchstens eine Seite.
Das solltest du erhalten Atlas zeigt womöglich zuerst sein Menü und wartet: Antworte mit deiner Anfrage oder mit dem Menücode CB (Product Brief erstellen). Danach fragt er nach und schreibt das Briefing unter _bmad-output/; den Dateinamen wählt der Skill, lies also den Pfad, den er nennt. Lies das Briefing wie den Entwurf eines Kollegen: Die Abnahmekriterien sollten prüfbar sein, und alles, was du nicht gesagt hast, sollte als Annahme markiert sein.
Nutze es für eine begrenzte Änderung. „Quick dev“ ist Forges Pfad mit minimalem Aufwand; er behält die angemessenen Prüfungen und überspringt die volle Pipeline.
In deinem KI-Assistenten
Forge, quick dev: füge der Rechnungsliste einen Ladezustand hinzu. Zeige mir vor dem Ändern, welche Dateien du anfasst, ändere nur diese, führe die vorhandenen Tests dazu aus und sage mir genau, was du ausgeführt hast und was bestanden hat.
Das solltest du erhalten Eine kurze Dateiliste, ein kleiner Diff und ein Bericht über die tatsächlich ausgeführten Prüfungen. Konnten die Tests in der Umgebung des Assistenten nicht laufen, sagt der Bericht das, statt Erfolg zu melden.
Bitte Sentinel, eine andere Rolle, zu prüfen, was Forge geliefert hat, gegen die Abnahmekriterien. Ist die BMAD+-Kommandozeile verfügbar, kann das Review versiegelt werden, sodass sein Urteil aus der Abdeckung folgt und nicht aus dem Ton: Es listet die Dateien, die es lesen muss, zitiert den Code jedes Befunds und endet mit incomplete, findings oder clean. Die Seite zum Code-Review erklärt diese drei Wörter.
Nutze es direkt nach einer Änderung, vor dem Commit.
In deinem KI-Assistenten
Sentinel, prüfe diese Änderung gegen die Abnahmekriterien im Briefing. Prüfe den Erfolgspfad und die wichtigsten Fehlerpfade. Ist die BMAD+-CLI verfügbar, versiegele zuerst den Scope mit bmad-plus review scope first-change --workspace, zitiere den Code jedes Befunds, berücksichtige jede ausgewählte Datei und berichte, was bmad-plus review gate antwortet. Sage, was du nicht prüfen konntest.
Das solltest du erhalten Ein Review in _bmad-output/review/first-change/, das mit einem Urteil endet. incomplete heißt, dass eine Datei nicht berücksichtigt wurde; findings listet, was zu beheben ist, jeweils mit zitiertem Code; clean heißt kein offener Befund in einem vollständig abgedeckten Scope, was kein Beweis für korrekten Code ist.
Eine neue Sitzung beginnt bei null. Ohne das Memory-Pack bittest du den Assistenten um eine kurze Übergabenotiz, die du im Projekt speicherst: was erledigt und verifiziert ist, was aussteht, die Entscheidungen und der nächste Schritt. Mit dem Memory-Pack übernimmt Zecher das und hält Entscheidungen, Erkenntnisse und Übergaben in .agents/memory/ fest. Du kannst das Pack später ergänzen: Ein erneuter Installer-Lauf mit --packs core,memory fügt nur Fehlendes hinzu und behält deine Konfiguration.
Im Terminal deines Projekts, um das Memory-Pack später zu ergänzen
Nutze es am Ende einer Arbeitssitzung, mit installiertem Memory-Pack. Ohne das Pack lässt du den Namen „Zecher“ weg, sprichst deinen Assistenten an und speicherst die Notiz selbst.
In deinem KI-Assistenten
Zecher, schreibe eine Übergabe für die nächste Sitzung. Trenne, was implementiert ist, was getestet ist, was nur geplant ist, die getroffenen Entscheidungen samt Begründung, die offenen Fragen und den genauen ersten Schritt danach. Daten als JJJJ-MM-TT. Keine Geheimnisse aufnehmen.
Das solltest du erhalten Eine datierte Notiz (mit Memory-Pack .agents/memory/sessions/YYYY-MM-DD-<topic>.md und ein aktualisierter context.md), die eine kalte Sitzung in unter einer Minute lesen und der sie trauen kann, weil sie Erledigtes von Geplantem trennt.
Standardmäßig benachrichtigt BMAD+ nur. update-check meldet die installierte und die veröffentlichte Version, ohne etwas zu ändern, und offline sagt es unbekannt, statt zu raten. update-policy zeigt oder setzt, ob Updates off, notify (Standard) oder auto (braucht einen ausdrücklichen Versionsbereich) sind. update ohne Option meldet „Nothing to update“, wenn die installierte Version dem ausführenden Paket entspricht; update --latest fragt npm.
Den Update-Zustand lesen, offline
$ npx --no-install bmad-plus update-check --offlineInstalled: 0.23.0; running: 0.23.0; channel latest: unknownunknown: offline$ npx --no-install bmad-plus update-policyUpdate policy: notify; channel=latest; range=none; prereleases=false$ npx --no-install bmad-plus update● Installed: v0.23.0 -> Executing package: v0.23.0◆ The installed version matches this executing package. Use --latest to check the registry.└ Nothing to update.
Ausgabe eines echten Laufs. Quelle: Auf einem Testserver am 2026-10-18 mit dem Quellcode 0.23.0 (tools/cli/bmad-plus-cli.js) in einem Wegwerf-Git-Projekt nachgespielt
Wird ein Update angewendet, bleiben von dir bearbeitete Dateien erhalten und werden gemeldet, ein Beleg und Sicherungen werden unter .bmad/updates/ geschrieben, und update --restore <receipt-id> --yes nimmt es zurück. Der Team-Leitfaden und die Seite zum Installations-Lebenszyklus nennen die Einzelheiten.