# Release-Record 1.9.0 — Marketing-Startseite und gerendertes Cheat-Sheet

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

## Was sich ändert

Der Owner wollte eine Startseite, die Menschen ohne Vorwissen abholt.
Kein Wort wie "Fahrer". Das Cheat-Sheet verlinkt und schön gerendert.
Die UX-Spines liegen unter
`_bmad-output/planning-artifacts/ux-designs/ux-BestAiConfig-2026-09-06/`.
Die Spec steht unter `_bmad-output/specs/spec-marketing-startseite/SPEC.md`.

| Bereich | Änderung | Wirkung für Nutzer |
|---|---|---|
| Startseite | `render_index_html` neu: Hero mit Versprechen, drei Schritte, drei Karten, drei Stufen, ein Befehl. Technik darunter, Dateien und Pfade aufklappbar. Reines HTML und CSS, Inline-SVG, keine externen Quellen (AD-12). Alle alten Pins bleiben | Ein Mensch mit einer Idee versteht in einer Minute, was er bekommt |
| Renderer neu | `src/compiler_markdown.py`: Markdown nach HTML, stdlib-only. Überschriften, Listen, Tabellen, Code, Zitate, Links, fett, Inline-Code. HTML im Markdown wird nie durchgereicht. Unsichere Link-Schemata bleiben Text | Jede Doku-Seite gibt es gerendert |
| Doku | Neben jeder `docs/*.md` und `docs/releases/*.md` liegt ein `.html`-Zwilling mit gleichem Rahmen wie die Startseite. Links auf `.md` zeigen auf den Zwilling. Das Gate lässt `.html` zu; HTML-Doku bekommt die erweiterten AD-12-Nadeln | `docs/cheat-sheet.html` ist der Knopf im Hero |
| Wording | "Fahrer" verschwindet aus Cheat-Sheet und README | Kein Jargon für Leser |
| Tests | `tests/test_compiler_markdown.py` (18 Tests); Startseite: Hero, Knopf, Technik nach dem Befehl, AD-12; Gate: HTML-Zwilling mit Event-Handler fällt durch; Wording-Test in `test_cheat_sheet.py` | Aussehen und Sicherheit sind gepinnt |

## Entscheidungen

- **Kein Script, keine externen Quellen.** AD-12 bleibt. Die Marke ist:
  schnell, sicher, ohne Tracker. Dekor nur als CSS-Verlauf und Inline-SVG.
- **Stdlib-Renderer statt Paket.** Q4 (keine Abhängigkeiten) bleibt. Der
  Renderer versteht die Formen der eigenen Doku; alles andere wird Text.
- **Markdown bleibt die Quelle.** Jede HTML-Seite verlinkt ihren
  Markdown-Zwilling in der Fußzeile.
- **Keine Assistenten-Namen in der Engine.** Die Vertrauenszeile sagt
  "Für alle gängigen KI-Assistenten"; Namen kommen aus der Registry.
- **Design "Klar und warm"** ist meine Wahl auf den Auftrag "stylisch".
  Änderbar in DESIGN.md.

## Nachweise

- Compile: 266 Prüfungen ok, 0 FAIL.
- Sichtprüfung: Screenshots der Startseite (1280 px und 600 px) und des
  Cheat-Sheets mit Headless-Chrome; Layout stimmt.
- Suite lokal und CI: siehe Pull Request.
- Live-Nachweis: siehe Nachtrag im Pull Request.

## Abhängigkeiten (gepinnt)

Unverändert gegenüber 1.8.0: `bmad-method@6.12.0`, `cis=v0.3.2`,
`tea=v1.24.0`, `cisco-ai-skill-scanner==2.0.14`.

## Rollback

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

1. Branch anlegen und den Stand 1.8.0 anwenden:
   ```sh
   git checkout -b rollback-1.9.0 main
   git diff --binary main 4791463 | git apply
   git add -A && git commit -m "rollback: Stand 4791463 (v1.8.0)"
   git push -u origin rollback-1.9.0
   ```
   Erwartete Ausgabe: `git diff --stat 4791463 HEAD` 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. Pages liefert wieder die
   alte Startseite; die `.html`-Zwillinge verschwinden.

Keine Datenmigration. Kein Reverse-Skript nötig.