# autoconfig

> BMAD+ in einem bestehenden Repository oder leeren Ordner einrichten: Stack erkennen, Projektgesundheit bewerten, Packs empfehlen, installieren und das Projektgedächtnis anlegen.

Canonical: https://bmad-plus.rochetta.fr/de/docs/reference/cli-autoconfig/
Language: de
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

BMAD+ Dokumentation › [Referenz](https://bmad-plus.rochetta.fr/de/docs/reference/) › autoconfig

`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.

<a id="synopsis"></a>
## Syntax

**Im Terminal deines Projekts**

```sh
npx bmad-plus autoconfig [-d <path>] [-l <code>] [-y]
```

**Optionen von autoconfig**

| Option | Argument | Standard | Wirkung |
| --- | --- | --- | --- |
| `-d, --directory <path>` | Pfad | aktuelles Verzeichnis | 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.

<a id="how-it-decides"></a>
## Wie entschieden wird

<a id="existing-project"></a>
### Bestehendes Projekt

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).

<a id="new-project"></a>
### Neues Projekt

In einem leeren Ordner fragt sie nach dem Projekttyp, dann nach einer Beschreibung in einem Satz, und installiert die zum Typ gehörenden Packs.

**Packs je Projekttyp**

| Projekttyp | Installierte Packs |
| --- | --- |
| Webanwendung (Web Application) | `core`, `memory`, `dev-studio`, `seo` |
| API / Backend (API / Backend) | `core`, `memory`, `dev-studio`, `shield` |
| Kommandozeilen-Tool (CLI Tool) | `core`, `memory` |
| Mobile App (Mobile App) | `core`, `memory`, `dev-studio` |
| Bibliothek / Paket (Library / Package) | `core`, `memory`, `dev-studio` |
| Sonstiges (Other) | `core`, `memory` |

<a id="reads-writes"></a>
## Was gelesen und geschrieben wird

- 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.

<a id="exit-codes"></a>
## Exit-Codes

**Exit-Codes von autoconfig**

| Code | Bedeutung |
| --- | --- |
| 0 | 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). |

<a id="real-output"></a>
## Was du siehst

**Bestehendes Next.js-Projekt mit CI-Ordner und ohne docs (simuliert)** (Simuliert)

```text
$ npx bmad-plus autoconfig --yes
BMAD+ Autoconfig
Existing project detected: invoice-app
Analysis complete
Project 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! 🚀
```

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.

<a id="errors"></a>
## Fehler und Abhilfe

**Meldungen von autoconfig**

| Meldung | Ursache | Abhilfe |
| --- | --- | --- |
| `Autoconfig install failed: <message>` | 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. |

<a id="examples"></a>
## Beispiele

<a id="example-cli-autoconfig-existing-repo"></a>
### Ein unbekanntes Repository einrichten

Du hast ein dir unbekanntes Projekt geklont und möchtest, dass BMAD+ die Packs auswählt.

**In deinem KI-Assistenten**

```text
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.

<a id="example-cli-autoconfig-new-idea"></a>
### Mit einem leeren Ordner beginnen

Du hast nur eine Idee und einen leeren Ordner und kannst im Terminal zwei Fragen beantworten.

**In deinem KI-Assistenten**

```text
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.

**Siehe auch**

- [install: Packs und Tools selbst wählen](https://bmad-plus.rochetta.fr/de/docs/reference/cli-install/)
- [memory: das Gedächtnis lesen, das autoconfig anlegt](https://bmad-plus.rochetta.fr/de/docs/reference/cli-memory/)
- [doctor: die Installation danach prüfen](https://bmad-plus.rochetta.fr/de/docs/reference/cli-doctor/)
- [Projektstruktur](https://bmad-plus.rochetta.fr/de/docs/reference/project-layout/)

[BMAD+ Dokumentation](https://bmad-plus.rochetta.fr/de/docs/) · [Referenz](https://bmad-plus.rochetta.fr/de/docs/reference/)

[Quellcode auf GitHub](https://github.com/lrochetta/BMAD-PLUS)