BMAD+ im Team nutzen

BMAD+ lebt im Projekt, ein Team teilt es also wie jeden anderen Teil des Repositorys: indem es entscheidet, was versioniert wird, was für alle gleich konfiguriert ist und wer es ändert. Diese Seite listet diese Entscheidungen und die Fakten auf, die jede absichern: Besitz-Hashes, erhaltene Änderungen, eine Update-Richtlinie je Projekt, aus einem Rückgrat generierte Adapter. Sie richtet sich an Tech Leads und alle, die Kollegen mit unterschiedlichen KI-Tools einarbeiten müssen. Wo eine Wahl Geschmackssache statt Tatsache ist, sagt der Text es.

Was versioniert wird und was lokal bleibt#

Konventionen, auf die man sich einigen sollte#

Ein Rückgrat, ein Adapter je Teammitglied#

Alle Adapter werden aus derselben Registry wie AGENTS.md generiert, ein Kollege mit Cursor und einer mit Claude Code bekommen also dieselbe Liste und dieselben Regeln; nur das Dateiformat unterscheidet sich. --tools nimmt mehrere IDs zugleich (--tools claude-code,cursor), all oder none. Der Installer erkennt Tools an ihren Ordnern (.claude/, .gemini/, .cursor/, .codex/, .opencode/, .aider.conf.yml), wenn du kein --tools angibst; --yes ohne erkanntes Tool schreibt keinen Adapter. Ein BMAD+-Adapter, den du bearbeitet hast, bleibt erhalten. Eine Anweisungsdatei, die du selbst geschrieben hast, bleibt bei einer interaktiven Installation und bei update erhalten; install --yes sichert sie zuerst als <file>.bak und ersetzt sie dann. Alte Installer-Dateien werden als <file>.bak gesichert.

Wer später ein Tool ergänzt, führt den Installer erneut mit diesem Tool aus: Der Lauf behält das bereits Installierte und fügt den fehlenden Adapter hinzu. --tools none installiert Agenten, Skills und Gedächtnis, ohne die Konfiguration irgendeines Tools anzufassen; das ist die richtige Option für ein Projekt, dessen CLAUDE.md oder AGENTS.md von Hand gepflegt wird.

Eine sichere Update-Richtlinie#

Der Standard ist Benachrichtigung: Die generierten Anweisungen bitten den Assistenten, einmal pro Sitzung update-check auszuführen und zu berichten. Nichts wird angewendet. Für ein Team ist das praktische Muster eine Person (oder ein CI-Job), die entscheidet, wann gewechselt wird, update anwendet, den Bericht prüft und committet; die anderen bekommen das Ergebnis mit ihrem nächsten Pull. Soll das Team Updates ohne Mensch durchlaufen lassen, braucht auto einen ausdrücklichen Semver-Bereich und mehrere Schutzbedingungen: Das Registry-Ergebnis muss frisch sein, die verwalteten Dateien unverändert, das Hash-Inventar der Installation vollständig, die Zielversion genau die im Befehl festgehaltene und die Node-Anforderung erfüllt. Eine Offline-, veraltete oder fehlgeschlagene Abfrage erlaubt nie ein automatisches Update.

$ npx bmad-plus update-policy
Update policy: notify; channel=latest; range=none; prereleases=false
$ npx bmad-plus update-policy --json
{"policy":{"mode":"notify","channel":"latest","allowedRange":null,"allowPrerelease":false,"registry":"https://registry.npmjs.org/"},"changed":false}
$ npx bmad-plus update-policy --mode auto --range "^0.23.0"
Update policy saved: auto; channel=latest; range=^0.23.0; prereleases=false
$ npx bmad-plus update-policy --mode notify
Update policy saved: notify; channel=latest; range=^0.23.0; prereleases=false
$ npx bmad-plus update-check --offline --json
{"schemaVersion":1,"installedVersion":"0.23.0","runningVersion":"0.23.0","latestVersion":null,"targetVersion":null,"channel":"latest","status":"unknown","checkedAt":null,"source":"none","stale":false,"updateAvailable":null,"releaseEligible":false,"versionEligible":false,"canAutoApply":false,"engineCompatible":null,"engines":{},"reason":"offline"}

• off stoppt jede Abfrage. notify (Standard) berichtet. auto braucht --range; ergänze --allow-prerelease oder --stable-only, um Vorabversionen zu steuern. Die Registry ist fest auf https://registry.npmjs.org/ gesetzt.
• Ein Update erhält seit dem erfassten Hash geänderte Dateien und meldet sie; ein Konflikt blockiert den automatischen Weg. Dateien, die eine neue Version nicht mehr liefert, werden nach einer wiederherstellbaren Sicherung entfernt. Jedes angewendete Update schreibt .bmad/updates/<receipt-id>/ mit receipt.json und backups/; update --restore <receipt-id> --yes kehrt dorthin zurück und überschreibt spätere lokale Änderungen nicht.
• Eine Installation vor 0.13 (ohne Datei-Hashes) lässt sich nicht automatisch aktualisieren; eine ausdrückliche Migration, npx --yes bmad-plus@0.23.1 update --yes, sichert, was sie ersetzt.
• install ändert nie die installierte Version: Ein Downgrade wird abgelehnt, und ein Upgrade läuft über update. Haben zwei Teammitglieder verschiedene Versionen installiert, führt das mit der älteren update aus.
• Eine Sperre .bmad/update.lock schützt das Projekt während eines Updates (nach 60 Minuten oder bei totem Besitzer als veraltet betrachtet); doctor meldet eine Sperre, die nicht seine eigene ist.

CI und Gates#

BMAD+ installiert keinen Git-Hook und keinen Lifecycle-Hook in deinem Projekt, weil eine Anweisung übersprungen werden kann. Was ein Team durchsetzen will, setzt es mit seiner eigenen CI durch, über Exit-Codes, die dafür gedacht sind.

Eine Kollegin oder einen Kollegen einarbeiten#

1. 01

   Repository ziehen und Installation prüfen

   Sind die generierten Dateien committet, funktioniert doctor bereits. Falls nicht, führe den Installer mit der Pack-Liste des Teams aus, dann doctor.

   Im Terminal deines Projekts

   npx bmad-plus@0.23.1 install --packs core,memory --tools claude-code
   npx bmad-plus@0.23.1 doctor

2. 02

   Das eigene Tool ergänzen

   Installiere mit der ID deines Tools; die vorhandenen Dateien bleiben erhalten und dein Adapter kommt hinzu.

   Im Terminal deines Projekts

   npx bmad-plus@0.23.1 install --packs core,memory --tools cursor

3. 03

   Das Rückgrat lesen, dann den Assistenten fragen

   Öffne AGENTS.md für die Agent-Liste und die Regeln des Teams und tippe bmad-help im Chat. Lies die Einstellungen in _bmad/config.yaml, damit du weißt, welche Checkpoints anhalten und dich fragen.

4. 04

   Das Gedächtnis mit deiner Maschine verknüpfen

   Mit dem Memory-Pack erkennt die Installation ein Brain auf deiner Maschine (BMAD_PLUS_BRAIN, ein Ordner _brain/ in einem übergeordneten Verzeichnis, ~/.bmad-plus/brain/, dann ein nicht leeres ~/.claude/memory/) und hält es in .agents/memory/.brain-link fest. Diese Datei gehört nur dir; die Projektgedächtnisdateien darum herum gehören dem Team.

Governance-Hinweise für Teams#

• Freigaben: Soll im Team eine Person Architektur und Auslieferung freigeben, lass require_approval an diesen Checkpoints. Ein Autopilot mit auto überall ist eine bewusste Entscheidung, kein Standard.
• Budget: Ein Schwarm über swarm.budget wird abgelehnt, bis ein Mensch Ja sagt; kostenpflichtige Medienerzeugung wird jedes Mal erfragt. Niemand sollte --approved im Namen eines anderen übergeben.
• OSINT: Die Recherche zu einer namentlich genannten Person verlangt bei jedem Lauf einen erfassten Zweck und eine Rechtsgrundlage. Im Team heißt das: jemand, der diese Entscheidung trägt. Siehe die Vertrauensseite.
• Shield: Die Berichte sind KI-generiert und tragen den Vermerk „not legal advice“; eine Compliance-Entscheidung bleibt bei einer qualifizierten Person.
• Geheimnisse: API-Schlüssel gehören in die Umgebung jeder Person oder der CI, nie ins Repository. Die Schwärzungs-Untergrenze von Review und Abnahmenotizen maskiert gängige Zugangsdaten-Formen; sie ersetzt nicht, keine Geheimnisse zu committen.
• Besitz: Jede von BMAD+ geschriebene Datei ist gehasht. Eine von einem Teammitglied bearbeitete Datei bleibt bei Update und Deinstallation erhalten und wird von doctor als geändert gemeldet (eine Warnung): Lokale Anpassung ist sichtbar und wird nicht still überschrieben.

Lies _bmad/config.yaml, _bmad/update-policy.json falls vorhanden, _bmad/review-rules.yaml falls vorhanden und das Manifest _bmad/.bmad-plus-install.json. Fasse in einer Tabelle zusammen: installierte Version, Packs, Tools, Ausführungsmodus, Verhalten jedes Kontrollpunkts, uat-Modus, Schwarm-Budget, Modus und Bereich der Update-Richtlinie. Liste dann auf, was ein neues Teammitglied tun müsste, um dasselbe Setup zu erhalten, und kennzeichne jede Einstellung, die mit den anderen unstimmig wirkt. Ändere nichts.