bmad+
Menü
DESprache wählen
Loslegen
Dokumentation durchsuchen

Installieren, aktualisieren, deinstallieren

Das ganze Leben von BMAD+ in einem Projekt: installieren, prüfen, mit Richtlinie und Belegen aktualisieren, wiederherstellen, deinstallieren und das Memory behalten. Was jeder Schritt schreibt.

Auf dieser Seite
  1. Der Weg in sechs Schritten
  2. Woran BMAD+ erkennt, was ihm gehört
  3. Was jeder Schritt liest, schreibt und entfernt
  4. Wenn du Dateien bearbeitet hast
  5. Offline arbeiten
  6. Wenn etwas schiefgeht
  7. Beispiel

BMAD+ lebt in deinem Projekt, neben deinem Code. Das wirft drei berechtigte Fragen auf: Wie installiere ich es, ohne dass es alles übernimmt, wie halte ich es aktuell, ohne meine Änderungen zu verlieren, und wie entferne ich es, ohne meine Arbeit zu verlieren. Diese Seite begleitet eine Installation vom ersten bis zum letzten Befehl und sagt zu jedem Schritt, was gelesen, geschrieben und entfernt wird. Das Prinzip ist überall gleich: BMAD+ führt eine Liste der Dateien, die ihm gehören, mit dem Fingerabdruck jeder einzelnen, und handelt nur an Dateien, die noch dazu passen.

Installieren, aktualisieren, deinstallieren und das Gedächtnis behalten Ein Installationsbefehl, eine Prüfung mit doctor, Updates, die deine Änderungen behalten, und eine Deinstallation, die Gedächtnis und Konfiguration stehen lässt.
Transkript

Ein einziger Befehl im Projektordner, dann wählst du deine Adapter und Packs. Der Installer schreibt die Agenten-Anweisungen, das gemeinsame Rückgrat des Projekts und die gewählten Adapter. Danach prüft doctor die Installation und meldet, wie viele Prüfungen bestanden wurden. Updates behalten deine angepassten Dateien: BMAD+ erfasst, welche Dateien es verwaltet. Eine Versionsprüfung schaut nur nach. Automatische Updates brauchen eine ausdrückliche Projektrichtlinie. Die Deinstallation entfernt nur Dateien, die noch dem entsprechen, was installiert wurde. Dein Gedächtnis, deine Änderungen und deine Konfiguration bleiben, wo sie sind. Sie löscht nie einen Ordner rekursiv, daher bleiben versteckte Dateien und verschachtelte Inhalte erhalten.

Transkript mit Bildbeschreibung

Das Transkript mit Bildbeschreibung als Seite öffnen

Untertitel (WebVTT)

Der Weg in sechs Schritten

  1. Installieren

    Kopiert Agenten, Skills und Anweisungsdateien, schreibt Konfiguration und Manifest.

    Im Terminal deines Projekts
    npx bmad-plus install

  2. Prüfen

    Ein schreibgeschützter Gesundheitsbericht: Sind alle Dateien da und unverändert?

    Im Terminal deines Projekts
    npx --no-install bmad-plus doctor

  3. Nach Neuem sehen

    npm fragen, ob es ein neueres Release gibt, ohne es anzuwenden.

    Im Terminal deines Projekts
    npx --no-install bmad-plus update-check

  4. Richtlinie festlegen

    Den Standard behalten (sag Bescheid, ich entscheide), Abfragen abschalten oder automatische Updates innerhalb eines Versionsbereichs erlauben.

    Im Terminal deines Projekts
    npx --no-install bmad-plus update-policy --mode notify

  5. Aktualisieren

    Planen, sichern, schreiben, prüfen, einen Beleg hinterlassen. Rückgängig mit --restore.

    Im Terminal deines Projekts
    npx --no-install bmad-plus update --latest --yes

  6. Deinstallieren

    Nur entfernen, was BMAD+ gehört; Memory, Einstellungen und deine Änderungen bleiben.

    Im Terminal deines Projekts
    npx --no-install bmad-plus uninstall --yes

Warnung Die Schritte 2 bis 6 brauchen eine lokale Kopie

Der Installer legt bmad-plus nicht im node_modules deines Projekts ab, daher scheitert npx --no-install bmad-plus ... direkt nach Schritt 1 (npx canceled due to missing packages and no YES option). Füge das Paket einmal mit npm install --save-dev bmad-plus hinzu oder führe diese Schritte als npx bmad-plus ... aus, das es bei Bedarf lädt. Die erzeugten CLAUDE.md und AGENTS.md weisen den Assistenten an, npx --no-install bmad-plus update-check auszuführen; ohne lokale Kopie ist der Befehl nicht verfügbar, und der Assistent überspringt die Update-Prüfung und macht mit deiner Aufgabe weiter. Siehe die CLI-Übersicht.

Woran BMAD+ erkennt, was ihm gehört

Alles ruht auf einer von install geschriebenen Datei: _bmad/.bmad-plus-install.json, dem Manifest. Es hält Version, Packs, Tools, deinen Namen und deine Sprache, den Ausführungsmodus, eine Map adapterHashes (ein Fingerabdruck je Anweisungsdatei) und ein fileInventory fest: für jede von BMAD+ gelegte Agenten-, Skill- und Datendatei ihren SHA-256-Fingerabdruck. Zeilenenden werden vor dem Fingerabdruck der Anweisungsdateien normalisiert, ein Windows-Checkout sieht also nicht wie eine Änderung aus.

Von doctor gezeigte Zustände des Besitzinventars
ZustandBedeutungFolge
completeJede gelieferte Datei ist verzeichnet.Updates können automatisch laufen, wenn die Richtlinie es erlaubt.
incompleteEine Datei war bei der Installation schon da, mit anderem Inhalt.Diese Dateien gelten als deine.
legacyInstalliert, bevor es Besitz-Hashes gab.Updates sichern zuerst die Original-Pack-Dateien; --auto lehnt ab.
invalidDas Inventar ist fehlerhaft.doctor meldet einen Fehler; Manifest reparieren oder neu installieren.

Was jeder Schritt liest, schreibt und entfernt

Wirkungen jedes Lebenszyklus-Befehls
BefehlLiestSchreibtEntfernt
installVorhandenes Manifest und Konfiguration.Agenten, Skills, Daten, Moduldateien, AGENTS.md und Tool-Dateien, _bmad/config.yaml, das Manifest, leere Ausgabeordner.Nichts.
doctorManifest, Dateien, Hashes, Sperre.Nichts.Nichts.
update-checkManifest, Richtlinie; npm außer bei offline oder off..bmad/update-check.json (Cache).Nichts.
update-policyRichtliniendatei._bmad/update-policy.json, nur wenn du Optionen angibst.Nichts.
updateManifest, Dateien, Hashes, Richtlinie.Geänderte Dateien, Manifest, .bmad/updates/<id>/ (Beleg, Backups), die Sperre.Dateien, die die neue Version nicht mehr liefert (unveränderte, mit Backup).
update --restoreBeleg und Backups.Die gesicherten Dateien, den Belegstatus.Dateien, die das Update hinzugefügt hatte.
uninstallManifest, Dateien.Nichts.Eigene, unveränderte Dateien, das Manifest, dann leere Ordner.

Wenn du Dateien bearbeitet hast

Wie jeder Befehl eine von dir geänderte Datei behandelt
Situationinstallupdateuninstall
Eine verwaltete Agenten- oder Skill-Datei, die du bearbeitet hastBehalten, Warnung.Behalten, als Konflikt aufgelistet.Behalten.
Eine Anweisungsdatei, die BMAD+ schrieb und du danach bearbeitet hastBehalten.Behalten, als Konflikt aufgelistet.Behalten.
Eine Anweisungsdatei, die du selbst geschrieben hast, nie von BMAD+Interaktiv behalten; mit --yes als <file>.bak gesichert, dann ersetzt.Behalten, als Konflikt aufgelistet.Behalten (keine Marke).
Eine von dir in einem BMAD+-Ordner abgelegte DateiUnberührt.Unberührt.Behalten, samt Ordner.
_bmad/config.yamlZusammengeführt, deine Schlüssel gewinnen.Unberührt.Behalten.

Offline arbeiten

  • Ist das Paket lokal installiert (füge es einmal mit npm install --save-dev bmad-plus hinzu und nutze danach npx --no-install bmad-plus ...), laufen install, doctor, update-policy, uninstall und ein schlichtes update ganz ohne Netz.
  • update-check und update --latest sind die einzigen Befehle, die npm fragen. Ohne Verbindung meldet update-check den Status unknown (Grund registry-unavailable, mit --offline offline), endet mit 0, und ein Assistent macht einfach mit deiner Aufgabe weiter.
  • Eine veraltete Cache-Antwort wird als solche gezeigt, mit stale: true; nie als aktuell.
  • Nur das allererste npx bmad-plus install braucht das Netz, um das Paket zu holen, es sei denn, du hast es aus einer Datei installiert.

Wenn etwas schiefgeht

  • Ein gescheitertes Update rollt sich selbst zurück und gibt den genauen Befehl update --restore <id> aus. Belege bleiben unter .bmad/updates/.
  • Eine Projektsperre (.bmad/update.lock), die älter als 60 Minuten ist oder deren Prozess weg ist, meldet doctor als veraltet samt der zu löschenden Datei. Eine Sperre, deren Prozess auf dieser Maschine nachweislich tot ist, übernimmt die nächste Installation oder das nächste Update.
  • Ein beschädigtes Manifest wird nach _bmad/.bmad-plus-install.json.corrupt.bak kopiert, bevor install es ersetzt.
  • Eine Installation aus der Zeit vor den Besitz-Hashes (0.12.2 oder älter) wird einmal migriert, indem du ausdrücklich ein neueres Paket startest: npx --yes bmad-plus@0.13.0 update --yes. Die Originale werden zuvor gesichert.
  • Ein Versions-Downgrade wird immer abgelehnt. Zum Zurückgehen nimm update --restore mit dem Beleg des Updates, das du rückgängig machen willst.

Beispiel

Ein Projekt aktualisieren, in dem du Anweisungsdateien bearbeitet hast

Du hast eigene Regeln in CLAUDE.md ergänzt und eine Agentendatei angepasst und willst das neueste BMAD+, ohne eines von beidem zu verlieren.

In deinem KI-Assistenten
Prüfe, ob es für dieses Projekt ein neueres BMAD+ gibt. Wenn ja, aktualisiere es und liste genau auf, welche Dateien erhalten blieben, weil ich sie bearbeitet habe, und warum.

Das solltest du erhalten Der Assistent führt update-check aus und mit deiner Zustimmung update --latest --yes. Der Befehl gibt einen Plan wie Planned changes: N files (R no longer shipped, removed with backup); preserved conflicts: 2. aus und eine Zeile je Konflikt: CLAUDE.md: preserved (local-instructions). und <agent file>: preserved (modified-managed-file). Diese beiden Dateien bleiben unberührt; alles andere wird nach einem Backup aktualisiert, und der Belegpfad unter .bmad/updates/ wird genannt, damit sich das Update mit update --restore rückgängig machen lässt.

Siehe auch