BMAD stellt die Installation komplett um, und das ist gut so

Wer die BMAD-Methode mit einem KI-Coding-Assistenten nutzt, hat sie vermutlich mit diesem Befehl installiert:

npx bmad-method install

Diesen Befehl streicht BMAD. Auf dem dev-Branch hat BMAD keinen eigenen Installer mehr. Es besteht jetzt aus einer flachen Sammlung von Skills. Ihr fügt sie mit der allgemeinen Skills CLI hinzu oder über einen Plugin-Marktplatz in Claude Code oder Codex:

npx skills add bmad-code-org/BMAD-METHOD

Wir halten das für eine gute Entscheidung. Hier steht, was sich geändert hat und warum.

Was passiert ist

Die Umstellung kam am 5. September 2026 mit PR #2768 (Merge-Commit 255c651). Sein Titel: „distribute BMAD as a flat skills tree via npx skills and plugin marketplaces“. Drei Commits daraus zeigen den Umfang:

• 3018779 entfernt den Einstiegspunkt des Installers samt Abhängigkeiten.
• 3c12a07 entfernt den Workflow für die Veröffentlichung auf npm.
• 636f8e2 entfernt das Veröffentlichungsskript und die veralteten v6-Shim-Skills.

Im Repository gibt es jetzt einen Ordner skills/ mit einem Unterordner pro Skill. Jeder Unterordner enthält die Anweisungen des Skills und ein kleines Manifest. Der dev-Branch hat keine package.json mehr. Die Python-Tools laufen über uv, also braucht ihr jetzt auch uv.

Die Arbeit des Installers erledigt jetzt ein Skill. Der neue Hub-Skill bmad hat zwei Befehle:

• bmad setup legt fehlende Dateien an und repariert veraltete. Ihr führt ihn nach der Erstinstallation und nach jedem Update aus.
• bmad status ändert nichts. Er zeigt die installierten Versionen und den nächsten Schritt.

Die Updates bezieht ihr über den Kanal, über den ihr installiert habt: npx skills update oder euren Plugin-Marktplatz.

Ihr habt die Wahl zwischen drei Installationswegen:

# Skills CLI, jedes Tool, das Skills unterstützt
npx skills add bmad-code-org/BMAD-METHOD

# Claude Code, innerhalb einer Session
/plugin marketplace add bmad-code-org/bmad-plugins

# Codex, im Terminal
codex plugin marketplace add bmad-code-org/bmad-plugins

Warum wir das gut finden

BMAD ist eine Möglichkeit, KI-gestützte Entwicklung zu strukturieren. Es ist nicht die einzige. Arbeitet euer Team mit KI-Assistenten, aber ohne Framework? Dann probiert eins aus. Den Unterschied seht ihr schnell, im Code und in den Reviews.

Deshalb halten wir es für richtig, den Installer zu streichen:

Ein Format statt einer Integration pro Assistent. Der alte Installer kannte jeden Assistenten einzeln und schrieb Dateien in dessen eigenen Ordner. Jeder neue Assistent bedeutete neuen Installer-Code, und die Liste der unterstützten Assistenten wurde nur länger. Skills sind ein gemeinsames Format. Ein Tester aus der Community hat bestätigt, dass die neue Struktur in opencode vollständig funktioniert. BMAD enthält dafür keinen eigenen Code für opencode.

Es passt zu den Werkzeugen, die Teams schon nutzen. Viele Entwickler verwenden die Skills CLI bereits für Skills aus anderen Quellen. Wir auch. Wir nutzen sie in mehreren Projekten und verteilen damit auch unsere internen Skills zwischen den Teams. BMAD ist kein eigenes Werkzeug mehr mit eigenem Installer, eigener Update-Routine und eigenen Regeln für die Ablage von Dateien. Es ist eine weitere Quelle in dem Setup, das wir schon haben. BMAD ist auch nicht das erste Projekt, das so ausliefert. Die Skills von Matt Pocock kommen über die Skills CLI oder ein Claude-Code-Plugin. Dazu gehört ein Setup-Skill, den man einmal ausführt, wie bmad setup.

Im Alltag zeigt npx skills list BMAD neben euren anderen Skills, und npx skills update aktualisiert BMAD zusammen mit dem Rest. Projektbezogene Skills committet ihr wie alle anderen mit dem Repository. Teams mit Claude Code oder Codex bekommen dasselbe über den Plugin-Marktplatz, den sie schon nutzen. Und keine Installer-Version kann mehr von den Skills abweichen, die sie installiert.

Ihr wählt, was ihr installiert. Der Installer dachte in Modulen: Ihr habt ein Modul gewählt und alle seine Skills bekommen. Mit der Skills CLI wählt ihr einzelne Skills. Wollt ihr nur bmad-build, installiert ihr ihn mit dem Hub und den zwei Modulordnern, die der Hub braucht. Sonst kommt nichts in euer Projekt:

npx skills add bmad-code-org/BMAD-METHOD --skill bmad --skill bmod-core-tools --skill bmod-method --skill bmad-build

Die Namen mit bmod- sind kein Tippfehler. BMAD ordnet seine Skills in Module, und jeder bmod--Ordner beschreibt ein Modul: seine Version und seine Skills. Der Hub liest diese Ordner für bmad setup und bmad status. Diese Konvention gibt es bisher nur auf dem dev-Branch. Noch enthält sie kein Release, auch 6.12 nicht.

Das Repository ist das Release. Bisher baute der Installer aus dem Quellcode auf GitHub erst eine Installation. Jetzt bekommt ihr genau die Dateien, die ihr auf GitHub lest. Überrascht euch ein Skill, öffnet ihr dieselbe Datei, die euer Assistent liest. BMAD soll einen KI-Assistenten steuern, deshalb zählt diese Transparenz.

Eine ganze Fehlerklasse fällt weg. Zwei Installationswege erzeugen zwei Verzeichnisstrukturen, und jeder Skill muss mit beiden funktionieren. Genau dieses Problem hatte BMAD. Seine Skills riefen Hilfsskripte in _bmad/scripts/ auf, und nur der npm-Installer legt diesen Ordner an. Nach einer Installation über den Plugin-Marktplatz fehlte der Ordner. Die Skripte liefen nie, und niemand bemerkte es. Die Skills nutzten einen Ausweichweg, und dessen Ergebnis sah gleich aus. Bei zwei Strukturen geht eine davon früher oder später kaputt, ohne dass es jemand bemerkt. Den zweiten Installationsweg zu streichen ist die ehrliche Lösung.

Was ihr beachten solltet

BMAD hat das noch nicht veröffentlicht. Das aktuelle Release ist weiterhin v6.12.0 vom 4. September, mit dem alten Installer. Fehlerbehebungen für 6.12 kommen weiter auf dem Branch V6.12. Die Version auf dev ist der Platzhalter 6.13.0-next.

Parallel zeigen die Maintainer als Vorschau einen größeren Umbau der Planung, den sie v7 nennen. Er ersetzt epics.md und sprint-status.yaml durch eine Struktur aus „Initiativen“ mit Tickets. Dazu kommt eine Migration von v6 auf v7 für bestehende Projekte. Die Maintainer haben nicht angekündigt, ob die neuen Installationswege als 6.13 kommen oder erst mit v7.

Einige Probleme sind noch offen:

• Die offiziellen Zusatzmodule (Test Architect, Creative Intelligence Suite, Builder und andere) verweisen noch auf den alten Installer. Noch beschreibt keine Dokumentation, wie ihr sie zu einem Kern aus den neuen Installationswegen hinzufügt (#2841).
• Die BMAD-Skripte beanspruchen die .venv des Projekts für sich. Das kollidiert mit Python-Projekten, die ihre eigene verwalten (#2823).
• Ihr braucht jetzt Node.js, Git und uv.

Unser Rat: Lasst Produktivprojekte vorerst auf 6.12. Testet den neuen Installationsweg in einem separaten Branch oder Worktree. Dann seid ihr vorbereitet, wenn das Release kommt.

Fazit

Ein Installer verspricht, dass das Projekt eure Umgebung besser kennt als ihr selbst. BMAD läuft in einem halben Dutzend KI-Assistenten, und jeder davon ändert sich jeden Monat. Mit jeder Änderung ließ sich dieses Versprechen schwerer halten. BMAD gibt dieses Versprechen jetzt nicht mehr. Es liefert schlichte Skills, überlässt die Installation Standardwerkzeugen und legt das Setup in einen Skill, den der Assistent selbst ausführen und reparieren kann. Ihr bekommt weniger versteckte Schritte und mehr Auswahl. Wir halten das für den richtigen Tausch.

Ihr wollt die KI-Arbeit in eurem Team so strukturieren und sucht dafür Unterstützung? Dafür gibt es unser Programm Guided AI.