# Fallstudie: prüfen, was Agenten als erledigt melden > Ein Review stufte 11 Aussagen als falsch ein in dem, was 39 Agenten in unter zwölf Stunden schrieben, und die Reviewer irrten zweimal. Sieh, wie es gefunden wurde, und spiel die fünf Befehle nach. Canonical: https://bmad-plus.rochetta.fr/de/docs/guides/case-study-rebuild-the-site/ 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/) › Fallstudie: prüfen, was Agenten als erledigt melden Wenn dir ein KI-Agent schon einmal „erledigt“ gemeldet hat und es nicht stimmte, ist diese Seite für dich. Sie zeigt, was passierte, als 39 Agenten Landingpage, Dokumentation, Beispiele und Videos dieser Website in unter zwölf Stunden neu bauten, zwischen dem Abend des 2026-10-18 und dem Morgen des 2026-10-19: Ein Review stufte 11 Aussagen als falsch ein, die Reviewer irrten zweimal, und ein Mensch entschied, was bleibt. Du siehst die fünf Schritte, die Zahlen mit ihren Quellen, die Fehler und die Befehle zum Nachspielen im eigenen Projekt. Wenn du es nur ausführen willst, spring zu [Spiel es selbst nach](#replay-it-yourself). > **Hinweis · Vor den Zahlen: die Schwächen** Lies das zuerst. Die Agenten wurden von Claude Code mit dessen eigenem Agent-Werkzeug gestartet, jeder Umsetzer in einem eigenen Git-Worktree, und nicht vom Befehl `bmad-plus swarm`: Dieser Befehl verteilt die Arbeit, schreibt die Briefings, prüft die Antworten und wertet sie aus, und überlässt das Starten deinem Assistenten. Die Reviewer sind auch Modelle, und zwei ihrer Befunde waren falsch. Es ist ein einziger Lauf, und noch hat niemand gemessen, ob Leser das Ergebnis klarer finden. Das Muster ist das, das BMAD+ mitbringt (erst fragen mit einem Intake, unter Budget verteilen, unabhängig prüfen, an Gates anhalten). Jede Zahl unten wurde am 2026-10-19 aus dem Repository, den Protokollen oder den Review-Berichten neu gezählt; eine Zahl, die sich nicht neu zählen ließ, steht nicht auf dieser Seite. Video: [Die KI sagte „fertig“. Stimmte das?](https://bmad-plus.rochetta.fr/media/case-study-en.mp4) — Wie 39 Agenten diese Website in unter zwölf Stunden neu gebaut haben, was die Reviewer fanden und die fünf Schritte und Befehle, um es selbst nachzuspielen. [Untertitel (WebVTT)](https://bmad-plus.rochetta.fr/media/case-study-de.vtt) Transkript: > Die KI sagte „fertig“. Stimmte das? Neununddreißig Agenten haben eine Website in unter zwölf Stunden neu gebaut. Reviewer fanden elf falsche Aussagen. Auch sie irrten sich zweimal. Du wurdest bestimmt schon von einem „fertig“ enttäuscht. So prüfst du es: fünf Schritte, fünf Befehle. Eins. Wie verhinderst du erfundene Fakten? Schreibe zuerst die Regeln: von Grund auf, Fakten aus dem Code, Simuliertes wird gekennzeichnet. Zwei. Was soll es fragen, bevor es startet? Der Intake listet auf, was bekannt ist und was fehlt. Drei. Wie kommen sich die Agenten nicht in die Quere? Ein Briefing pro Seite, je eine Kopie des Repos. BMAD+ verteilt die Briefings und begrenzt jede Welle. Dein Assistent startet die Agenten. Vier. Wer prüft die Arbeit? Fünf Leser, die nichts davon geschrieben haben und Befehle auf einem sauberen Server nachspielen. Und das Gate sagt Nein, bis jede Datei erfasst ist. Ein Versprechen, dass deine Dateien bleiben. Ein Befehl, den es nie gab. Eine Zählung, die um eins danebenlag. Fünf. Korrigieren, dann belegen: neunzehn Fix-Commits, 1.879 Tests, null Barrierefreiheits-Verstöße. Ein Mensch hatte das letzte Wort. Noch hat niemand gemessen, ob Leser es klarer finden. Du bekommst fünf Befehle, drei Schwarm-Dateien, das Review-Gate und sieben Fehler, die du vermeiden kannst. Beginne mit Schritt eins. „Fertig“ ist nur eine Behauptung. Spiel es nach. Transkript mit Bildbeschreibung: - **0:00** Im Bild: Ein schwarzer Bildschirm mit einem weichen bernsteinfarbenen Schimmer in der Mitte. Das Wort „Done.“ knallt in riesigen weißen Buchstaben mit bernsteinfarbenem Schein ins Bild, darunter steht ein bernsteinfarbener Haken. Dann zerspringt der Haken zu einem Fragezeichen: Feine weiße Risse gehen von ihm aus, während das Wort bebt. Sprechtext: Die KI sagte „fertig“. Stimmte das? - **0:02** Im Bild: Ein dunkles Feld hoher Glas-Monolithen im Dunst; die Kamera fährt auf einen von ihnen zu, der einen leuchtenden bernsteinfarbenen Kern hat. Eine große bernsteinfarbene „39“ schlägt ein, darunter „agents“ in Weiß und dann „under 12 hours“ in Bernstein. Sprechtext: Neununddreißig Agenten haben eine Website in unter zwölf Stunden neu gebaut. - **0:06** Im Bild: Nahaufnahme des bernsteinfarbenen Kerns eines Monolithen, die Kamera fährt weiter heran. Eine riesige bernsteinfarbene „11“ schlägt ein, darunter „false claims“ in Weiß und kleiner „in one review“. Dann erscheint unten „wrong twice, too“ in Bernstein. Sprechtext: Reviewer fanden elf falsche Aussagen. Auch sie irrten sich zweimal. - **0:11** Im Bild: Ein abgedunkeltes Terminalfenster; oben rechts steht klein „replayed output“. Darüber, in zwei Zeilen: „You have probably been burned by „done““. Das Terminal tippt npx bmad-plus review gate site; echo "exit code: $?" und gibt „site: incomplete — coverage 0/1 completed (0 waived), 0 open finding(s), 0 refuted“ aus, dazu drei Zeilen mit Gründen (no coverage.json, no findings.json, eine ausgewählte Datei nie erfasst: site/contact/index.md) und „exit code: 2“. Das Wort „incomplete“ ist orange umrandet, die Ansicht zoomt darauf. Dann erscheint ein dunkles Band mit „5 steps · 5 commands“ in großen bernsteinfarbenen Buchstaben. Sprechtext: Du wurdest bestimmt schon von einem „fertig“ enttäuscht. So prüfst du es: fünf Schritte, fünf Befehle. - **0:16** Im Bild: Ein dunkler Stapel aus Glasplatten im bernsteinfarbenen Licht, die Kamera fährt langsam heran. Oben links eine große bernsteinfarbene „1“ und der Titel „Write the rules first“. Es folgen drei Karten im Abstand von etwa einer Sekunde, jede mit einem dünnen bernsteinfarbenen Balken links: „From scratch“, „Facts from the code“ und „Simulated? Labelled.“ Unten bilden fünf kurze Balken eine Fortschrittslinie; der erste ist bernsteinfarben. Sprechtext: Eins. Wie verhinderst du erfundene Fakten? Schreibe zuerst die Regeln: von Grund auf, Fakten aus dem Code, Simuliertes wird gekennzeichnet. - **0:25** Im Bild: Ein Terminal mit „replayed output“ oben rechts. Der Befehl npx bmad-plus install --yes --lang en --packs core,design,memory --tools claude-code wird getippt. Der Installer gibt „BMAD+ Installer v0.23.0“, „Installing to: /home/dev/app“, „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“ und „Installation complete — Getting started“ aus. Eine blasse Zeile sagt „getting-started box, 40 lines“ anstelle des Kastens, und die letzte Zeile, „BMAD+ is ready! Talk to Atlas to get started“, ist orange umrandet. Ein Band oben lautet „One install gives your assistant its roles“. Die Fortschrittslinie zeigt weiter einen bernsteinfarbenen Balken. - **0:29** Im Bild: Ein Terminal. Der Befehl npx bmad-plus intake record wird getippt, mit der intake.yaml des Design-Packs, einer Antwortdatei und drei Antworten: surface_kind=landing, audience=„Urban professionals who buy coffee most days“ und job=„Get a first-time visitor to open a loyalty card“. Die Ausgabe lautet „Recorded surface_kind, audience, job in _bmad-output/design/intake.json.“, dann „design-read (design): ready — 3 answered, 0 defaulted, 0 unknown, 10 not asked yet.“ und „Ask next (at most 6 per message):“, gefolgt von den ersten Fragen (brand_assets, design_system, aesthetic_family und weitere). Orange Ringe umkreisen „3 answered“, dann „10 not asked yet“, dann „at most 6 per message“. Unten links eine große bernsteinfarbene „2“ und „Ask first“; die Fortschrittslinie hat zwei bernsteinfarbene Balken. Sprechtext: Zwei. Was soll es fragen, bevor es startet? Der Intake listet auf, was bekannt ist und was fehlt. - **0:35** Im Bild: Eine Glasplatte teilt sich in viele identische Platten, die sich in einem Bogen auffächern, jede Kante mit einer dünnen bernsteinfarbenen Linie, während die Kamera um sie kreist. Oben links eine bernsteinfarbene „3“ und „Fan out“. Ein großer bernsteinfarbener Zähler läuft von 1 bis 39, darunter „agents“ in Weiß. Drei Balken der Fortschrittslinie sind bernsteinfarben. Sprechtext: Drei. Wie kommen sich die Agenten nicht in die Quere? Ein Briefing pro Seite, je eine Kopie des Repos. - **0:41** Im Bild: Ein Terminal mit „replayed output“ oben rechts. Der Befehl npx bmad-plus swarm init --definition swarm/page-fanout.json --units swarm/units.json wird getippt; die Ausgabe lautet „site-pages-20261019-g3ip: fanout of 3 units, budget 26, approval not-needed.“, „Units listed, no seed.“ und „Next: bmad-plus swarm briefs site-pages-20261019-g3ip“. Dann gibt npx bmad-plus swarm briefs site-pages-20261019-g3ip „3 of 3 units need a sub-agent, in waves of 10.“ aus, mit orange umrandetem „in waves of 10“, einer ersten Welle mit den Briefings der Seiten about, pricing und contact und einer Zeile, die mit „Disclosure:“ beginnt: „Each page was written by a separate sub-agent from the same brief; read them together before publishing.“ Am Ende zeigt ein dunkles Band unten „39 agents“, „133 commits“ und „244 pages“ in Bernstein, nacheinander. Sprechtext: BMAD+ verteilt die Briefings und begrenzt jede Welle. Dein Assistent startet die Agenten. - **0:48** Im Bild: Ein dunkles Feld, von orangefarbenen Lichtstrahlen durchzogen. Oben links eine bernsteinfarbene „4“ und „Make someone else try to break it“ in zwei Zeilen. Fünf dünne bernsteinfarbene Linien zeichnen sich nacheinander, jede mit einem Wort darüber: „facts“, „reference“, „examples“, „languages“ und „accessibility“. Vier Balken der Fortschrittslinie sind bernsteinfarben. Sprechtext: Vier. Wer prüft die Arbeit? Fünf Leser, die nichts davon geschrieben haben und Befehle auf einem sauberen Server nachspielen. - **0:54** Im Bild: Eine geschlossene Tür aus dunklem Glas und gebürstetem Metall, ein bernsteinfarbener Lichtstrahl über ihrer Fläche; die Kamera fährt langsam heran, die Tür bleibt zu. In bernsteinfarbener Festbreitenschrift: „incomplete · exit 2“, darunter in Grau „coverage 0/1 completed“. Sprechtext: Und das Gate sagt Nein, bis jede Datei erfasst ist. - **0:58** Im Bild: Dünne Glasplatten treiben im Dunkeln. Drei Karten erscheinen nacheinander. „Your files are kept“, in Anführungszeichen, wird von einer roten Linie durchgestrichen und durch „backed up, then replaced“ in Bernstein ersetzt. „/animated“ wird durchgestrichen und durch „does not exist“ ersetzt. „26 frameworks“ wird durchgestrichen und durch eine große bernsteinfarbene „27“ ersetzt. Sprechtext: Ein Versprechen, dass deine Dateien bleiben. Ein Befehl, den es nie gab. Eine Zählung, die um eins danebenlag. - **1:04** Im Bild: Ein dunkler Gitterwürfel mit feinen bernsteinfarbenen Linien. Oben links eine bernsteinfarbene „5“ und „Fix, then prove“. Drei Zeilen zählen hoch, jede mit einem grünen Haken am Ende: „19 fix commits“, „1,879 tests“ und „0 accessibility violations“. Alle fünf Balken der Fortschrittslinie sind bernsteinfarben. Sprechtext: Fünf. Korrigieren, dann belegen: neunzehn Fix-Commits, 1.879 Tests, null Barrierefreiheits-Verstöße. - **1:13** Im Bild: Ein trüber, dunkler Himmel. In großen weißen Buchstaben: „A person kept the last call.“ Dann, in Grau, „Not yet measured:“ und, in Bernstein, „do readers find it clearer?“ Sprechtext: Ein Mensch hatte das letzte Wort. Noch hat niemand gemessen, ob Leser es klarer finden. - **1:18** Im Bild: Dunkle Glas-Monolithen mit warmem Streiflicht. Eine Liste baut sich Zeile für Zeile auf, jede mit einer großen bernsteinfarbenen Ziffer und einer weißen Beschriftung: „5 commands“, „3 swarm files“, „1 review gate“ und „7 mistakes to avoid“. Sprechtext: Du bekommst fünf Befehle, drei Schwarm-Dateien, das Review-Gate und sieben Fehler, die du vermeiden kannst. - **1:24** Im Bild: Dunkelblauer Dunst. In bernsteinfarbener Festbreitenschrift „npx bmad-plus install“, mit einer bernsteinfarbenen Unterstreichung, die sich darunter zeichnet; dann „bmad-plus.rochetta.fr“ in Weiß und, kleiner und grau, „docs · guides · case study“. Sprechtext: Beginne mit Schritt eins. - **1:26** Im Bild: Wieder die Glas-Monolithen, die Kamera fährt zurück. Der Satz „Done“ is a claim. erscheint in Weiß, mit „Done“ in Anführungszeichen, und blendet dann aus. Ein großes bernsteinfarbenes Fragezeichen erscheint mit weißen Rissen, die von ihm ausgehen, wie im ersten Bild, und das Bild blendet in dunkles Blau aus. Sprechtext: „Fertig“ ist nur eine Behauptung. Spiel es nach. ## Was es brauchte, in Zahlen **Was der Neubau ergab und woher jede Zahl stammt** | Größe | Wert | Woher sie stammt | | --- | --- | --- | | Agenten, bis zum integrierten Branch | 39 | Das gespeicherte Protokoll der Sub-Agenten der Sitzung | | Commits auf dem Integrations-Branch | 133 (118 gewöhnliche, 15 Merges) | `git log` seit `master` | | Geänderte Dateien | 328 (72.665 Zeilen hinzugefügt, 650 entfernt) | `git diff --shortstat` | | Seiten der Website | 8 vorher, 244 nachher, jede mit Markdown-Spiegel | Die Live-Sitemap vom 2026-10-18, dann die Build-Ausgabe | | Dokumentationsseiten | 52 pro Sprache, in vier Sprachen | Das Seitenregister | | Beispiele und Terminal-Mitschnitte | 160 Beispiele; 70 Mitschnitte, davon 19 simuliert und als solche gekennzeichnet | Das Seitenregister | | Videos | 6, auf Englisch und Französisch gesprochen, 24 Untertiteldateien | Das Medien-Manifest | | Unabhängige Reviewer | 5, mit je einem schriftlichen Bericht | Die Review-Berichte vom 2026-10-19 | | Fix-Commits nach den Reviews | 19, auf vier Branches | `git log` der vier Fix-Branches | | Tests und Prüfungen am Ende | 79 Website-Tests, 1.879 Tests der Hauptsuite, 91.986 Suchprüfungen, 2.539 Release-Prüfungen | Die Läufe der Gates | | Browser-Lauf | 976 Viewport-Fälle, 300 Barrierefreiheits-Läufe, 0 Verstöße | Das Protokoll der Browser-Prüfung | | Zeit | 11 Stunden 52 Minuten von der Anfrage bis zum integrierten Branch, davon 3 Stunden 21 Minuten Pause | Zeitstempel von Commits und Sitzung | | Medien-Credits | Etwa 709 Credits für 15 generierte Clips und die Sprecherstimme | Das Credit-Register | ## Fünf Schritte zum Nachmachen 1. **Erst die Regeln aufschreiben** Schreibe das Ziel in einem Satz auf und die Regeln, die nie nachgeben. Hier war das Ziel eine Website, die jede Möglichkeit von BMAD+ in vier Sprachen abdeckt, mit Videos. Die Regeln: alles von Grund auf geschrieben, Fakten nur aus dem Repository, alles Simulierte sagt es, und nichts läuft auf dem eigenen Rechner des Eigentümers (Builds und Tests liefen auf einem Testserver, in Containern). 2. **Erst fragen lassen, dann handeln** Bevor ein Agent startete, wurde die Arbeit aufgelistet: was es gab und was fehlte (die neuen Befehle hatten weder Beispiel noch Referenzseite). Danach erweiterte der Eigentümer den Umfang. In BMAD+ ist dieser Schritt der Intake: Er hält fest, was beantwortet, per Standard gesetzt oder unbekannt ist, und stellt höchstens sechs Fragen pro Nachricht. ```sh npx bmad-plus intake plan --intake .agents/skills/pack-design/intake.yaml --answers _bmad-output/design/intake.json ``` 3. **Jedem Agenten seine Seite und seine Kopie geben** Ein Agent inventarisierte zuerst das ganze Produkt. Dann entstanden Landingpage, Dokumentation, Bildschirmaufnahmen und Videos parallel, jeder Agent in seinem eigenen Git-Worktree und seiner eigenen Kopie des Projekts auf dem Testserver, mit Umfängen, die sich nicht überlappen, damit sich die Branches zusammenführen ließen. In BMAD+ ist dieselbe Form eine Schwarm-Definition mit einer Einheit pro Seite und disjunkten Umfängen. ```sh npx bmad-plus swarm init --definition swarm/page-fanout.json --units swarm/units.json ``` 4. **Jemand anderen versuchen lassen, es zu brechen** Fünf Reviewer, die nichts geschrieben hatten, lasen das Ergebnis an einem festen Commit: einer prüfte die Fakten der Seiten zu Packs, Agenten und Konzepten, einer Referenz, Anleitungen, Sicherheit, FAQ und Landingpage, einer spielte die Beispiele nach, einer las Französisch, Spanisch und Deutsch, einer steuerte einen Browser für die Barrierefreiheit. Sie spielten Befehle auf einem sauberen Server nach, statt dem Text zu glauben. In BMAD+ ist die Beweisschicht `review`: Sie versiegelt den Umfang und verweigert ein Urteil, solange nicht jede Datei erfasst ist. ```sh npx bmad-plus review scope site --workspace --base HEAD npx bmad-plus review gate site ``` 5. **Korrigieren, dann belegen** Sieben Fix-Gruppen und vier Fix-Durchgänge korrigierten, was die Reviews fanden (19 Fix-Commits auf vier Branches). Ein Integrator führte 14 Branches zusammen und ließ alle Gates erneut laufen: 79 Website-Tests, 1.879 Tests, 91.986 Suchprüfungen, 2.539 Release-Prüfungen und einen Browser-Lauf mit 976 Viewport-Fällen und 300 Barrierefreiheits-Läufen ohne einen Verstoß. Es wurde nichts veröffentlicht, bevor der Eigentümer es sagte. ## Was die Reviewer fanden und wo sie irrten Du erwartest vielleicht, dass Agenten, die den Code gelesen haben, die Fakten richtig wiedergeben. Das taten sie nicht immer. Diese sieben Aussagen überstanden das Nachspielen des Befehls oder das Lesen des Codes nicht, und jede wurde korrigiert. **Sieben Aussagen, die ein Nachspielen nicht überstanden** | Was der Entwurf sagte | Was der Reviewer fand | Die Korrektur | | --- | --- | --- | | Der Installer bewahrt Anweisungsdateien, die du geschrieben hast. | Mit `install --yes` wird eine selbst geschriebene `CLAUDE.md` nach `CLAUDE.md.bak` kopiert und dann ersetzt. Der Satz stand auf vier Seiten. | Die Seiten sagen: nicht stillschweigend. Interaktive Installationen und Updates bewahren sie, `--yes` sichert sie zuerst, `--tools none` berührt keine Werkzeugkonfiguration. | | Drei Befehle auf der Landingpage, als lauffähig dargestellt. | Nachgespielt: `intake plan` verlangt `--answers`, `mem recall` mit Evidenz-Ranking verlangt einen Projektbereich, `swarm init` brauchte `--context pitch=DATEI`. | Die Befehle tragen die fehlenden Optionen und laufen. | | Ein Prompt, der mit `/animated` begann. | Einen Befehl `/animated` gibt es im Produkt nirgends. | Der Prompt ist der Satz, auf den der Agent hört: eine animierte Website aus einem Video bauen. | | Ein Nexus-Beispiel, das direkt nach `create` `verification=passed` ausgab. | Nachgespielt scheitert `verify` direkt nach `create` mit Exit-Code 1: Es braucht abgeschlossene, nicht angenommene, abgeglichene Arbeit. | Das Beispiel startet, erfasst und prüft jetzt eine echte Aufgabe, mit nachgespielter Ausgabe. | | Befehle nach der ersten Installation beginnen mit `npx --no-install`. | In einem Projekt, das nie `npm install --save-dev bmad-plus` ausgeführt hat, bricht dieser Befehl mit „npx canceled due to missing packages“ ab. | Die Beispiele nutzen `npx bmad-plus`; die Form `--no-install` wird dort erklärt, wo sie vorkommt, mit ihrer Voraussetzung. Die vom Installer erzeugten Anweisungsdateien sagen noch `--no-install`: Das braucht ein Release und ist noch nicht behoben. | | Zwei Videoclips des Installers zeigten Shield mit 26 Rahmenwerken. | Das Register zählt 27, und alle anderen Seiten sagten 27. | Beide Clips wurden mit dem aktuellen Installer neu aufgenommen. | | Untertitel: ein Cue pro Satz, und französische Untertitel, die die Sprecherstimme umformulierten. | Zeilen von bis zu 79 Zeichen, Cues von bis zu 11 Sekunden; die französischen Untertitel passten nicht zu den gesprochenen Wörtern. | Alle 24 Untertiteldateien sind auf 2 Zeilen mit 42 Zeichen und 6 Sekunden geschnitten; die französischen folgen der Stimme Wort für Wort. | > **Warnung · Auch die Reviewer irrten sich** Zwei Befunde hielten nicht stand. Ein Review behauptete, 0.23.0 sei nicht auf npm; sie ist es, und die Befehle auf dieser Seite installieren sie. Ein anderes meldete englische Titel in den französischen Videos; der Video-Regisseur prüfte die Bilder erneut: Die Einblendungen waren schon französisch, und das verbleibende Englisch ist echte Terminal-Ausgabe, absichtlich beibehalten. Ein Reviewer ist ein zweiter Leser, kein Orakel: Jeder Befund wurde geprüft, bevor er behoben wurde, und ein Mensch behielt das letzte Wort. ## Wo ein Mensch entschied - Loszulegen, mit parallelen Schwärmen, und den Umfang auf jede Möglichkeit des Produkts und auf Präsentationsvideos mit Sprecherstimme zu erweitern. - Die Sprecherstimme: Die erste wurde abgelehnt, eine ElevenLabs-Stimme (Celine) wurde nach dem Anhören freigegeben. - Dokumentation, Beispiele und CLI-Referenz parallel zu starten statt nacheinander. - Wer im README und in der npm-Beschreibung wofür genannt wird. - Eine vollständige Sicherung der Live-Seite, bevor sie ersetzt wird. - Die Formulierung zweier öffentlicher Aussagen: Dev Studio wird als original beschrieben, und die Karte des SEO-Packs heißt „SEO / GEO“. - Eine Pause, während der Eigentümer abwesend war, und die Wiederaufnahme in derselben Nacht. - Dass nichts veröffentlicht wird, bevor der Eigentümer es sagt. ## Spiel es selbst nach Fünf Befehle tragen die Methode: `install`, `intake plan`, `swarm init`, `review scope` und `review gate`. Die Blöcke unten führen sie aus, mit den wenigen Befehlen drumherum, die sie zum Laufen bringen. Du kannst nach jedem Block aufhören. Du brauchst Node.js 20 oder neuer und ein Git-Projekt mit mindestens einem Commit. Die Blöcke unten sind echte Ausgabe des veröffentlichten Pakets 0.23.0. Wo Sub-Agenten ihre Antworten schreiben würden, schreibt der Schwarm-Teil drei kleine Antwortdateien von Hand: Es läuft kein Modell, die Auswertung zählt also Ersatzantworten und sagt nichts über echte Seiten. Definition, Briefing-Vorlage und Einheitendatei stehen auf der [Schwarm-Seite](https://bmad-plus.rochetta.fr/de/docs/concepts/swarm/#file-units). **Die Packs installieren** ```text $ npx bmad-plus install --yes --lang en --packs core,design,memory --tools claude-code # Ausgabe auf die letzte Zeile gekürzt. BMAD+ is ready! Talk to Atlas to get started 🚀 ``` Ausgabe eines echten Laufs. Quelle: Am 2026-10-19 mit dem veröffentlichten Paket 0.23.0, über npx gestartet, in einem sauberen Node-20-Container nachgespielt, in einem Wegwerf-Git-Projekt **Erst fragen: Antworten festhalten, dann auflisten, was offen ist** ```text $ npx bmad-plus intake record --intake .agents/skills/pack-design/intake.yaml --answers _bmad-output/design/intake.json --set surface_kind=landing --set "audience=Urban professionals who buy coffee most days" --set "job=Get a first-time visitor to open a loyalty card" Recorded surface_kind, audience, job in _bmad-output/design/intake.json. $ npx bmad-plus intake plan --intake .agents/skills/pack-design/intake.yaml --answers _bmad-output/design/intake.json design-read (design): ready — 3 answered, 0 defaulted, 0 unknown, 10 not asked yet. Ask next (at most 6 per message): - brand_assets [choice] Which brand assets exist already? None, a partial set (a logo and a colour or two), or a full kit (logo, palette, type, voice)? (choices: none, partial, full) # Fünf weitere Fragen folgen in der echten Ausgabe. ``` Ausgabe eines echten Laufs. Quelle: Am 2026-10-19 mit dem veröffentlichten Paket 0.23.0, über npx gestartet, in einem sauberen Node-20-Container nachgespielt, in einem Wegwerf-Git-Projekt **Verteilen: ein Briefing pro Seite, dann die Antworten prüfen und auswerten** ```text $ npx bmad-plus swarm init --definition swarm/page-fanout.json --units swarm/units.json site-pages-20261019-kgoi: fanout of 3 units, budget 26, approval not-needed. Units listed, no seed. Next: bmad-plus swarm briefs site-pages-20261019-kgoi $ npx bmad-plus swarm briefs site-pages-20261019-kgoi site-pages-20261019-kgoi: 3 of 3 units need a sub-agent, in waves of 10. Wave 1: about /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/briefs/about.md pricing /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/briefs/pricing.md contact /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/briefs/contact.md Each sub-agent: Read the brief and follow it exactly; it is your whole instruction. Disclosure: Each page was written by a separate sub-agent from the same brief; read them together before publishing. # Hier wurden die drei Antwortdateien von Hand geschrieben, dort, wo jeder Sub-Agent seine eigene schreiben würde. $ npx bmad-plus swarm check site-pages-20261019-kgoi site-pages-20261019-kgoi: 3 of 3 valid answers. $ npx bmad-plus swarm tally site-pages-20261019-kgoi /work/app/.bmad-plus/swarm/runs/site-pages-20261019-kgoi/tally.md 3 of 3 units counted; 0 skipped. Disclosure: Each page was written by a separate sub-agent from the same brief; read them together before publishing. ``` Ausgabe eines echten Laufs. Quelle: Am 2026-10-19 mit dem veröffentlichten Paket 0.23.0, über npx gestartet, in einem sauberen Node-20-Container nachgespielt, in einem Wegwerf-Git-Projekt **Review: den Umfang versiegeln und das Gate verweigern sehen** ```text $ npx bmad-plus review scope site --workspace --base HEAD /work/app/_bmad-output/review/site/scope.json 1 file(s) to review, 1 changed lines, 1 unit(s) — scope 1ef2d235ea25 checklist: /work/app/_bmad-output/review/site/checklist.md plan: medium effort, 2 pass(es), refutation pass Every selected file must end in coverage.json as completed, failed or waived (with a reason). $ npx bmad-plus review gate site site: incomplete — coverage 0/1 completed (0 waived), 0 open finding(s), 0 refuted - no coverage.json: which files were reviewed is not established - no findings.json: write it even when there is nothing to report - 1 selected file(s) never accounted for: site/contact/index.md # Exit-Code 2: Das Urteil bleibt unvollständig, bis der Reviewer Abdeckung und Befunde schreibt. ``` Ausgabe eines echten Laufs. Quelle: Am 2026-10-19 mit dem veröffentlichten Paket 0.23.0, über npx gestartet, in einem sauberen Node-20-Container nachgespielt, in einem Wegwerf-Git-Projekt ### Mehrere Seiten parallel neu schreiben und von einem Dritten angreifen lassen Nutze es, wenn mehrere Seiten oder Abschnitte gleichzeitig geändert werden sollen, ohne dass sich Agenten überschreiben, und du einen Reviewer willst, der keine davon geschrieben hat. Du brauchst die drei Schwarm-Dateien aus dem Nachspielen oben und ein Git-Projekt mit einem Commit. **In deinem KI-Assistenten** ```text Starte den Schwarm site-pages aus swarm/page-fanout.json und swarm/units.json: ein Sub-Agent pro Seite, jeder auf seinen eigenen Ordner beschränkt, eine Welle nach der anderen. Wenn die Antworten da sind, führe swarm check und swarm tally aus und berichte zuerst den Offenlegungshinweis. Führe dann mit einem anderen Sub-Agenten, der keine der Seiten geschrieben hat, review scope auf dem Arbeitsbaum gegen HEAD aus, lies jede geänderte Datei und spiele jeden Befehl nach, den die Seiten zeigen. Nimm keine Seite an, deren Befehl scheitert, und sag mir, welche Behauptung der Reviewer nicht prüfen konnte. ``` **Das solltest du erhalten** Die Briefings werden geschrieben, die Sub-Agenten antworten in Wellen zu höchstens 10, `swarm check` meldet die gültigen Antworten, und `tally.md` beginnt mit dem Offenlegungshinweis. Der Reviewer versiegelt mit `review scope` einen Umfang, und `review gate` bleibt mit Exit-Code 2 unvollständig, bis jede geänderte Datei durch eine geschriebene Abdeckungs- und Befunddatei erfasst ist. Ein Befehl, der beim Nachspielen scheitert, wird als Befund gemeldet, nicht stillschweigend behoben. ## Was das nicht beweist, damit du selbst urteilst - Ein Projekt und ein Lauf: Es zeigt, dass die Methode Fehler fangen kann, nicht wie oft. - Die Reviewer sind auch Modelle. Ein Befund ist ein Hinweis zum Prüfen, und zwei davon waren falsch. - Die Auswertungen auf dem Bildschirm und in den Beispielen sind Demonstrationen und als solche gekennzeichnet. - Niemand hat gemessen, ob die Website leichter zu verstehen ist. Die Prüfungen decken Fakten, Barrierefreiheitsregeln und Struktur ab, nicht Verständlichkeit. - Die französischen, spanischen und deutschen Texte prüfte ein Agent gegen das Englische und ein gemeinsames Glossar, kein muttersprachlicher Korrektor. - Die Videos wurden von Skripten und von einem Agenten geprüft, der Bilder ansieht. Wie sie klingen und wirken, bleibt ein menschliches Urteil. **Siehe auch** - [Tutorial: von der Idee zum Schwarm](https://bmad-plus.rochetta.fr/de/docs/guides/idea-to-swarm/) - [Die Schwarm-Dateien: Definition, Briefing und Einheiten](https://bmad-plus.rochetta.fr/de/docs/concepts/swarm/#file-units) - [bmad-plus review: Umfang, Abdeckung und Urteil](https://bmad-plus.rochetta.fr/de/docs/reference/cli-review/) - [Nexus: die Aufgaben ausführen und jede prüfen](https://bmad-plus.rochetta.fr/de/docs/concepts/nexus-orchestration/) [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)