BMAD+ in einem bestehenden Repository oder leeren Ordner einrichten: Stack erkennen, Projektgesundheit bewerten, Packs empfehlen, installieren und das Projektgedächtnis anlegen.
autoconfig ist der Ein-Befehl-Start für ein Projekt, das noch nicht eingerichtet ist. Statt die Packs selbst auszuwählen, lässt du BMAD+ den Ordner ansehen, eine Pack-Auswahl empfehlen, install damit ausführen und einen ersten Projektkontext ins Gedächtnis schreiben. Nutze es, wenn du in einem unbekannten Repository landest oder noch nicht weißt, welche Packs du brauchst. Weißt du schon, was du willst, bietet dir install die volle Kontrolle.
Ein Pack ist ein installierbares Bündel aus Agenten und Skills (siehe den Abschnitt zu den Packs). Ein Projekt gilt als bestehend, wenn sein Ordner mindestens einen sichtbaren Eintrag enthält, also einen, dessen Name nicht mit einem Punkt beginnt. Sonst gilt es als neu.
Projekt, das analysiert und in das installiert wird.
-l, --lang <code>
en, fr, es, de, pt-br, ru, zh, he, ja, it
en
Sprache, die an den ausgeführten Installer weitergegeben wird. Die eigenen Meldungen von autoconfig bleiben Englisch.
-y, --yes
keiner
aus
Nur bestehendes Projekt: überspringt die Rückfrage „Install N recommended packs?“. Die Fragen für ein neues Projekt überspringt es nicht.
Warnung· --yes macht ein neues Projekt nicht unbeaufsichtigt
In einem leeren Ordner stellt der Assistent immer zwei Fragen (Projekttyp, Beschreibung in einem Satz), egal was --yes sagt. Führe ihn in einem Terminal aus, in dem du antworten kannst.
Er liest den Ordner, zeigt eine kurze Analyse (Stack, Struktur, eine Gesundheitsleiste, ob BMAD+ oder eine Anweisungsdatei schon vorhanden ist), listet die empfohlenen Packs mit je einem Grund, fragt nach Bestätigung (außer mit --yes), installiert und gibt bis zu fünf nächste Schritte aus, formuliert als Briefings an einen Agenten.
Welche Packs empfohlen werden
Pack
Empfohlen, wenn
core, memory
Immer.
dev-studio
Es gibt keinen Ordner docs, doc oder documentation, oder das Projekt hat mehr als fünf sichtbare Verzeichnisse auf oberster Ebene (node_modules zählt nicht).
shield
Ein Ordner .github, .gitlab-ci oder .circleci oder eine Datei Dockerfile, docker-compose.yml oder docker-compose.yaml ist vorhanden.
seo
Das in package.json erkannte Framework ist Next.js, Nuxt, Angular, React, Vue.js oder Svelte.
Die Gesundheitsleiste ist eine gewichtete Checkliste. Ihr Wert ist der gerundete Anteil am Gesamtgewicht von 10; er beeinflusst nur die abschließenden Hinweise und ändert nie, welche Packs empfohlen werden.
Gesundheits-Checkliste
Prüfung
Gewicht
Zählt, wenn
Quellcode
2
ein Verzeichnis src, lib oder app existiert
Tests
2
ein Verzeichnis tests, test, __tests__ oder spec existiert
Dokumentation
1
ein Verzeichnis docs, doc oder documentation existiert
CI/CD
1
ein Verzeichnis .github, .gitlab-ci oder .circleci existiert
Git
1
ein Verzeichnis .git oder eine Datei .gitignore existiert
README
1
README.md oder readme.md existiert
Lizenz
1
LICENSE oder LICENSE.md existiert
Docker
1
Dockerfile oder eine docker-compose-Datei existiert
Die Stack-Erkennung liest zuerst package.json (Framework, TypeScript und Paketmanager anhand von pnpm-lock.yaml, yarn.lock oder bun.lockb, sonst npm). Ohne package.json sucht sie Cargo.toml (Rust), pyproject.toml oder requirements.txt (Python), go.mod (Go), composer.json (PHP), Gemfile (Ruby), pom.xml oder build.gradle (Java).
Liest: die Einträge der obersten Ebene, package.json, tsconfig.json, die Lockfiles und die oben genannten übrigen Manifeste. Es gibt keine Netzwerkanfrage und es wird kein weiterer Prozess gestartet.
Schreibt: alles, was install für die gewählten Packs schreibt (es ruft den Installer mit --yes auf), danach .agents/memory/context.md.
Anweisungsdateien: Existiert im Wurzelverzeichnis schon CLAUDE.md, GEMINI.md oder AGENTS.md, übergibt es --tools none und lässt jeden Adapter in Ruhe. Sonst übergibt es die Tools, deren Markierungsordner es findet (zum Beispiel .claude), oder none, wenn es keinen gibt.
In einem neuen Projekt übergibt es keine Option --tools: Der Installer erkennt selbst und schreibt mit --yes keinen Adapter, wenn er kein Tool findet.
Warnung· context.md wird neu geschrieben
autoconfig ersetzt .agents/memory/context.md durch eine erzeugte Datei (Stack, Struktur, Gesundheit, wichtige Verzeichnisse, installierte Packs oder das Projektbriefing bei einem neuen Projekt). Alles, was du oder ein Agent dort geschrieben hat, wird überschrieben. Führe es einmal am Anfang aus, nicht in einem Projekt, dessen Kontext du pflegst.
Fertig, oder du hast eine Rückfrage abgelehnt oder abgebrochen (dann wurde nichts installiert).
1
Der aufgerufene Installer ist fehlgeschlagen. autoconfig setzt selbst keinen Code; der Installer setzt 1, wenn er ablehnt (zum Beispiel bei einem Versionskonflikt) oder einen Fehler wirft (die CLI gibt dann BMAD+: <message> aus).
Bestehendes Next.js-Projekt mit CI-Ordner und ohne docs (simuliert)Simuliert
$ npx bmad-plus autoconfig --yesBMAD+ AutoconfigExisting project detected: invoice-appAnalysis completeProject Analysis Stack: Next.js + TypeScript + Node.js (npm) Structure: src/ tests/ CI/CD no docs Health: ████████░░ 80%Recommended Packs ✓ core Essential multi-role agents (Atlas, Forge, Sentinel, Nexus) ✓ memory Persistent brain for context continuity across sessions ✓ dev-studio No docs/ found — Huldah (Tech Writer) will help document ✓ shield CI/CD and/or Docker detected — GRC compliance agents recommended ✓ seo Next.js web app detected — SEO audit agents recommended# Danach läuft der Installer genau wie auf der Seite install, ohne Rückfragen.Recommended Next Steps ! "Forge, document the project architecture and API" · "Forge, continue developing the current module" · "Zecher, consolidate session memory"Autoconfig complete! 🚀
npx bmad-plus autoconfig --yes
Beispielhafter Ablauf, nicht bei einem echten Lauf aufgezeichnet. Quelle: Zusammengesetzt aus den Meldungsvorlagen in tools/cli/commands/autoconfig.js; Farben, Emojis und Rahmenzeichen ausgelassen
Die Gesundheitszahl stammt aus der Checkliste oben: Dieses fiktive Projekt hat Quellcode, Tests, CI, Git, README und Lizenz (8 von 10), aber weder docs noch Docker. Die nächsten Schritte folgen festen Regeln: Fehlende Tests ergeben einen Sentinel-Schritt mit hoher Priorität, fehlende docs und CI ergeben Forge-Schritte, ein Wert unter 60 Prozent ergänzt eine Sentinel-Prüfung, vorhandener Quellcode ergänzt „weiterentwickeln“, und ein Zecher-Schritt steht am Ende. Es werden höchstens fünf Schritte ausgegeben, ein Projekt, das alle fünf anderen Regeln auslöst, sieht den Zecher-Schritt also nicht. Die 80 Prozent setzen Git, ein README und eine Lizenz voraus, die die Zeile Structure nicht aufführt: Mit Git, aber ohne README und Lizenz zeigt dieselbe Zeile 60 Prozent.
Der Installer hat einen Fehler geworfen; die CLI gibt denselben Fehler danach als BMAD+: <message> aus, der Exit-Code ist 1.
Lies die Meldung oder führe install direkt aus, um denselben Fehler im Kontext zu sehen.
BMAD+ v<old> is installed; this package is v<new>. Run bmad-plus update first ...
Das Projekt enthält eine andere BMAD+-Version. Der Installer lehnt ab und setzt den Exit-Code auf 1, autoconfig gibt aber trotzdem seine eigenen Schlusszeilen aus.
Führe update aus, dann autoconfig erneut. Verstehe „Installation complete“ nicht als Erfolg, wenn der Exit-Code 1 ist.
Autoconfig cancelled.
Du hast die Rückfrage verneint oder eine Frage des Assistenten abgebrochen.
Es wurde nichts installiert. Starte erneut, wenn du bereit bist.
autoconfig: Failed to list directory <message>
Der Ordner konnte nicht gelesen werden. Das Ergebnis ist eine leere Liste, also gilt er als neues Projekt.
Prüfe den bei --directory angegebenen Pfad und seine Rechte, bevor du dem Assistenten antwortest.
Du hast ein dir unbekanntes Projekt geklont und möchtest, dass BMAD+ die Packs auswählt.
In deinem KI-Assistenten
Führe `npx bmad-plus autoconfig --yes` in diesem Repository aus. Sag mir danach, welche Packs empfohlen wurden und warum, und welchen Agentenauftrag es zuerst vorschlägt.
Das solltest du erhalten Der Assistent führt den Befehl aus, der die Analyse ausgibt, einen Grund je empfohlenem Pack (core und memory immer, die übrigen nach den obigen Regeln) und sie installiert. Er berichtet dir die Pack-Liste mit jedem ausgegebenen Grund und die erste Zeile von „Recommended Next Steps“ (die erste zutreffende Regel, zum Beispiel ein Sentinel-Schritt, wenn es keine Tests gibt). .agents/memory/context.md enthält jetzt die erzeugte Zusammenfassung zu Stack und Gesundheit.
Du hast nur eine Idee und einen leeren Ordner und kannst im Terminal zwei Fragen beantworten.
In deinem KI-Assistenten
Führe in diesem leeren Ordner `npx bmad-plus autoconfig` aus. Wenn es fragt, wähle „Web Application“ und beschreibe das Projekt so: eine Buchungsseite für eine kleine Physiotherapiepraxis.
Das solltest du erhalten Es gibt „Empty directory — starting new project wizard“ aus, installiert core, memory, dev-studio und seo (das Web-Application-Set), schreibt .agents/memory/context.md mit Typ, deiner Beschreibung und dem Status „New — not started“ und gibt vier erste Schritte aus: Atlas bitten, das beschriebene Projekt zu bauen, Atlas um das PRD bitten, Forge um die Architektur bitten oder „autopilot“ sagen.