# Release-Record 1.4.1 — BMAD 6.12.0

Datum: 2026-09-04. Version `1.4.1` in `pyproject.toml`. Commit-Hash:
siehe Merge-Commit des Pull Requests. Ausgeliefert nach dem Merge durch
`deploy.yml`.

## Was sich ändert

`bmad-method` steigt von 6.11.0 auf 6.12.0 (erschienen 2026-09-04,
02:31 UTC). Die Modul-Pins `cis=v0.3.2` und `tea=v1.24.0` bleiben.

| Bereich | Änderung | Wirkung für Nutzer |
|---|---|---|
| Tools | `bmad-method@6.12.0` in `targets.json` | Build entscheidet nach der Untersuchung über den Umfang; Review-Triage protokolliert jeden Befund; Fixes in Customization, Review-Dispatch, Windows-Encoding |
| Router | Schritt 1 nennt die aktuellen Skill-Namen: `project-context`, `build`, `review`, `walkthrough` | Der Router zeigt auf Skills, die eine frische 6.12-Installation hat. Die alten Weiterleitungen (`quick-dev`, `dev-story`, `document-project`, `editorial-review`) installiert 6.12 nur noch mit `--shims` |
| Doku | README und `docs/erweiterungen.md` nennen 6.12 | Stimmige Versionsangaben |

## Breaking Changes von 6.12.0 und ihre Wirkung hier

| Änderung upstream | Wirkung auf BestAiConfig |
|---|---|
| `persistent_facts` ist leer; `project-context.md` wird nicht mehr automatisch geladen | Keine. Die eigenen Overrides unter `_bmad/custom/` nutzen `persistent_facts` nicht |
| `{diff_output}` heißt `{diff_file}` | Keine. Kein eigener Review-Override |
| Shims nur noch mit `--shims` auf frischen Installationen | Der Install-Befehl trägt `--no-shims`. Frische wie bestehende Installationen haben danach 49 statt 70 BMAD-Skills; das Roster sinkt um 90 Wörter |
| `bmad-checkpoint-preview` heißt `bmad-walkthrough` | Router nennt `walkthrough` |
| Build startet nicht mehr bei Formatier- und Git-Arbeiten von selbst | Keine |
| `llms.txt` wird nicht mehr veröffentlicht | Keine |

**Warum `--no-shims` im Befehl steht.** Ohne den Schalter behält ein
Update die 21 alten Weiterleitungs-Skills und bietet ihr Entfernen nur
in einem interaktiven Quick Update an. Der Bootstrap läuft ohne Dialog.
Mit dem Schalter entfernt der Installer die Shims auch bei bestehenden
Installationen (geprüft am 2026-09-04 in diesem Repo: 116 auf 95 Skills,
Roster 2619 auf 2434 Wörter). Der Router nennt nur noch aktuelle Namen,
sodass keine eigene Regel einen Shim braucht.

## Nachweise

- Testinstallation 6.12.0 in ein leeres Projekt: core, bmm, cis, tea
  installiert; 69 Skills (49 BMAD, 20 Module).
- Suite lokal grün (siehe Pull Request).
- Live-Install nach dem Deploy: siehe Nachtrag im Pull Request.

## Abhängigkeiten (gepinnt)

| Abhängigkeit | Version | Ort |
|---|---|---|
| bmad-method (npm) | 6.12.0 | `targets.json` |
| bmad-module-creative-intelligence-suite (GitHub-Tag) | v0.3.2 | `targets.json` |
| bmad-method-test-architecture-enterprise (GitHub-Tag) | v1.24.0 | `targets.json` |

## Rollback

Dauer: etwa 20 Minuten (davon 15 Minuten CI und Deploy).

1. `targets.json` und Router aus Commit `b7fedc9` zurückholen. Das
   nimmt auch `--no-shims` heraus, denn 6.11.0 kennt den Schalter nicht:
   ```sh
   git checkout -b rollback-1.4.1 main
   git checkout b7fedc9 -- targets.json sources/custom/skill-router.md
   git commit -am "rollback: bmad-method 6.11.0"
   git push -u origin rollback-1.4.1
   ```
   Erwartete Ausgabe: `git diff --stat b7fedc9 -- targets.json` ist leer.
2. Pull Request öffnen und mergen. Erwartete Ausgabe: das CI-Gate ist grün.
3. Der Deploy startet nach dem Merge von selbst.
4. In betroffenen Projekten den Install erneut ausführen. BMAD geht auf
   6.11.0 zurück; der Installer erlaubt ein Downgrade, weil `--action
   update` die Version aus dem Befehl nimmt.

Keine Datenmigration. Kein Reverse-Skript nötig.