# Deine erste Stunde mit BMAD+ > 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. Canonical: https://bmad-plus.rochetta.fr/de/docs/guides/first-hour/ Language: de BMAD+ version: 0.23.1 Documentation reviewed: 2026-10-19 Author: Laurent Rochetta License: MIT BMAD+ Dokumentation › [Anleitungen](https://bmad-plus.rochetta.fr/de/docs/guides/) › Deine erste Stunde mit BMAD+ 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. Video: [BMAD+ im Überblick](https://bmad-plus.rochetta.fr/media/overview-en.mp4) — Was BMAD+ installiert, wie ein Pack vor dem Handeln fragt, wie ein Schwarm ehrlich ausgewertet wird und welche zehn Packs es gibt. [Untertitel (WebVTT)](https://bmad-plus.rochetta.fr/media/overview-de.vtt) 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. Transkript mit Bildbeschreibung: - **0:00** Im Bild: Dunkelblauer Dunst füllt den Bildschirm. Der Titel „BMAD+ 0.23.0“ steht in der Mitte, und hinter ihm wächst langsam ein warmes Licht. Sprechtext: BMAD+ installiert Rollen, Workflows und gemeinsamen Kontext in das KI-Coding-Werkzeug, das du bereits nutzt. - **0:09** Im Bild: Ein einzelner bernsteinfarbener Lichtpunkt in einer dunklen blaugrünen Wolke, von dem schwache Strahlen ausgehen. Die Einblendung unten lautet auf Englisch „Ask first“. Sprechtext: Es beginnt mit Fragen: Ein Pack legt fest, was beantwortet sein muss, bevor es handelt. - **0:19** Im Bild: Ein Terminalfenster mit dem Titel „~/app“. Es wird ein Befehl getippt: bmad-plus intake record, mit der intake.yaml des Packs Design und einer Antwortdatei, drei Antworten (surface_kind=dashboard; audience=„Accountants in a practice, on a desktop, at month end“; job=UNKNOWN) und einem Standardwert für design_system. Die Ausgabe zeigt „Recorded surface_kind, audience, job, design_system“, dann „design-read (design): ready — 2 answered, 1 defaulted, 1 unknown, 9 not asked yet.“ und die Liste der nächsten Fragen, jeweils mit ihrem Typ (choice, number oder text): brand_assets, aesthetic_family, variance, motion, density und stack. Das Bild zoomt auf die letzte Zeile, in der „Unknown: job“ umrahmt ist: „risk: There is no goal to review against, so hierarchy and the primary action cannot be judged, only decorated.“ Der gesamte Terminaltext ist englisch. Sprechtext: Du beantwortest jeweils ein paar, und was du nicht weißt, wird als unbekannt mit seinem Risiko festgehalten. - **0:27** Im Bild: Bernsteinfarbene Partikel schießen aus einem hellen Zentrum und bilden vor einem dunkelvioletten Hintergrund einen sich weitenden Ring. Die Einblendung lautet auf Englisch „A swarm, within a budget“. Sprechtext: Danach kann Nexus einen Schwarm von Sub-Agenten starten, innerhalb eines Budgets, das du festlegst. - **0:33** Im Bild: Zwei Terminalbereiche nebeneinander. Links wird bmad-plus swarm tally buyer-panel-20261018-zho8 getippt. Der Befehl gibt den Pfad einer Datei tally.md aus, „8 of 40 units counted; 32 skipped.“ und eine Zeile, die mit „Disclosure:“ beginnt, dem Offenlegungshinweis: „Simulated units are not people. Read rates as an upper bound and confirm with real ones.“ Der rechte Bereich öffnet tally.md. Die Überschrift, orange umrahmt, lautet „Simulated buyers see the pitch (run buyer-panel-20261018-zho8)“, gefolgt von „8 of 40 units gave a valid answer; 32 skipped“ und einer Tabelle „Rate: buys“ (die Zeile „all“ zeigt 4 yes von 8, 50.0%). Der Bereich scrollt durch kurze zitierte Antworten, nach Segment und Verhalten gruppiert, und hält bei „Numbers: price_floor“ an: eine Tabelle mit den Spalten group, count, median, mean, min und max, deren erste Zeile, „all“, 8, 3.65, 3.7, 3 und 4.5 zeigt. Sprechtext: 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. - **0:48** Im Bild: Ein Knäuel dünner, verschlungener Bernsteinlinien richtet sich Linie für Linie zu einem quadratischen Raster mit einem hellen Punkt in der Mitte auf. Die Einblendung lautet auf Englisch „Independent checks before acceptance“. Sprechtext: Bei geplanter Arbeit verlangt Nexus unabhängige Prüfungen, bevor es ein Ergebnis akzeptiert. - **0:54** Im Bild: Hohe, dunkle, glasartige Platten stehen in einer Reihe und werden von der Seite von einem warmen Schimmer beleuchtet. Die Einblendung lautet auf Englisch „10 packs · 7 adapters“. Sprechtext: Vier Core-Rollen, neun optionale Packs und Adapter für sieben KI-Coding-Werkzeuge. - **1:04** Im Bild: Ein Terminal. Es wird der Befehl npx bmad-plus install --lang en --packs core,design --tools claude-code getippt. Die Zeilen des Installers erscheinen: „BMAD+ Installer v0.23.0“, „Installing to: /home/dev/app“, „Selected packs: Core, Design“, „Detected IDEs: Claude Code“, eine Frage nach dem Vornamen (Developer), die Kommunikationssprache (English), eine Frage nach der URL einer Testumgebung und der Ausführungsmodus, mit Manual, Autopilot und Hybrid zur Auswahl und „Manual — You call agents yourself“ beibehalten. Das Bild zoomt auf zwei grüne Haken: „5 agents, 9 skills, 4 files copied“, wobei „files copied“ orange umrahmt ist, und „1 IDE(s) configured“. Der gesamte Terminaltext ist englisch. Sprechtext: Installiert wird mit einem einzigen npx-Befehl im Projektordner. - **1:12** Im Bild: Ein gedämpfter blauschwarzer Himmel mit einem schwachen Lichtband am Horizont. Die Adresse „bmad-plus.rochetta.fr“ blendet in Orange ein und wieder aus. > **Tipp · Zwei Arten von Anweisung** 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. ## Teil 1. Installieren 1. **Öffne ein Terminal im Projekt und prüfe Node.js** Nimm das Repository, an dem du arbeiten willst. Der Befehl sollte v20 oder höher ausgeben; installiere oder aktualisiere sonst Node.js separat. ```sh node --version ``` 2. **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. ```sh npx bmad-plus@0.23.1 install ``` 3. **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`. ```sh npx bmad-plus@0.23.1 install --yes --packs core --tools claude-code ``` 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** ```text $ npx bmad-plus install --yes --lang en --packs core --tools claude-code $ git status --short ?? .agents/ ?? AGENTS.md ?? CLAUDE.md ?? _bmad/ $ ls .agents/skills agent-architect-dev agent-orchestrator agent-quality agent-strategist bmad-plus-autopilot bmad-plus-intake bmad-plus-parallel bmad-plus-swarm bmad-plus-sync bmad-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. ``` 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 ## Teil 2. Prüfen und den Assistenten aufwecken 1. **Füge das Paket dem Projekt hinzu (einmalig)** 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 ` 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. ```sh npm install --save-dev bmad-plus ``` 2. **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. ```sh npx --no-install bmad-plus doctor ``` 3. **Ö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. 4. **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. ```sh bmad-help ``` ## Teil 3. Eine erste Aufgabe 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. ### Von einer Idee ausgehen Nutze es, wenn es noch keinen Code gibt oder du das Problem aufschreiben willst, bevor du etwas änderst. **In deinem KI-Assistenten** ```text 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. ### Eine kleine Änderung in vorhandenem Code machen 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** ```text 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. ## Teil 4. Prüfen lassen 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. ### Sentinel um ein ehrliches Review bitten Nutze es direkt nach einer Änderung, vor dem Commit. **In deinem KI-Assistenten** ```text 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. ## Teil 5. Das Gelernte bewahren 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** ```sh npx bmad-plus install --packs core,memory ``` ### Die Sitzung mit einer Übergabe beenden 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** ```text 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-.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. ## Teil 6. Sicher aktuell bleiben 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** ```text $ npx --no-install bmad-plus update-check --offline Installed: 0.23.0; running: 0.23.0; channel latest: unknown unknown: offline $ npx --no-install bmad-plus update-policy Update 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 --yes` nimmt es zurück. Der Team-Leitfaden und die Seite zum Installations-Lebenszyklus nennen die Einzelheiten. ## Wie es weitergeht **Wähle die nächste Seite nach deinem Ziel** | Du willst | Lies | | --- | --- | | Verstehen, was BMAD+ tut und nicht tut | So funktioniert BMAD+ | | Ein ganzes Projekt automatisieren oder Aufgaben parallel laufen lassen | Nexus, Autopilot und parallele Arbeit | | Ein Pack zuerst die richtigen Fragen stellen lassen | Intake: erst fragen, dann handeln | | Einen Pitch oder eine Seite an vielen simulierten Lesern testen | Schwärme aus Sub-Agenten | | Ein komplettes Beispiel von der Idee bis zur Auswertung durchgehen | Tutorial: von der Idee zum Schwarm | | Prompts für jedes Pack kopieren | Rezeptbuch | | Wissen, was deine Maschine verlässt | Datenverarbeitung | | Ein Setup im Team teilen | BMAD+ im Team nutzen | | Ein Problem lösen | Fehlerbehebung und FAQ | **Siehe auch** - [So funktioniert BMAD+](https://bmad-plus.rochetta.fr/de/docs/concepts/how-bmad-plus-works/) - [Tutorial: von der Idee zum Schwarm](https://bmad-plus.rochetta.fr/de/docs/guides/idea-to-swarm/) - [Rezeptbuch](https://bmad-plus.rochetta.fr/de/docs/guides/recipes-cookbook/) - [BMAD+ im Team nutzen](https://bmad-plus.rochetta.fr/de/docs/guides/for-teams/) - [FAQ](https://bmad-plus.rochetta.fr/de/docs/faq/faq/) - [Fehlerbehebung](https://bmad-plus.rochetta.fr/de/docs/faq/troubleshooting/) [BMAD+ Dokumentation](https://bmad-plus.rochetta.fr/de/docs/) · [Anleitungen](https://bmad-plus.rochetta.fr/de/docs/guides/) [Quellcode auf GitHub](https://github.com/lrochetta/BMAD-PLUS)