windgeschworen/docs/ROADMAP.md
danny 1b34931d6e CR 27: Poker wird echtes Texas Hold'em
Die CR-17-Variante — eine Setzrunde, je fuenf Karten, kein Aufdecken —
fuehlte sich nicht wie Poker an. Ersetzt durch Heads-up Hold'em: zwei
verdeckte Hole Cards je Seite, die fuenf Gemeinschaftskarten decken sich als
eigene Reihe zwischen den Haenden in drei Schritten auf (Flop, Turn, River),
vier Setzrunden mit Checken, Mitgehen, Erhoehen und Aussteigen. Kleiner und
grosser Blind wechseln pro Hand; der Small Blind handelt Pre-Flop zuerst und
schuldet dort die Blind-Differenz. Fixed Limit mit maximal zwei Erhoehungen
pro Strasse, damit der Pott lesbar bleibt.

CardDeck.evaluate_best_of bewertet die beste 5-aus-N-Kombination ueber einen
allgemeinen Kombinationszaehler — am River 21 Kombinationen; die
Gegner-Einschaetzung ruft am Flop und Turn auch mit fuenf oder sechs Karten
an, der naive Lass-zwei-weg-Ansatz waere am Turn falsch gewesen.

Der Gegner spielt eine Hand konsistent: ob er blufft, wuerfelt er einmal pro
Hand, nicht pro Entscheidung; seine Einschaetzung waechst mit jeder
aufgedeckten Strasse aus der echten Teilbewertung, skill mischt Wahrheit und
Rauschen. Pre-Flop zaehlt eine Hole-Card-Heuristik.

Spieltisch-Anbindung (Einsatz, Sitzordnung, Ridocs Dealer-Regel),
card_view-Platzhalter und das Messerspiel bleiben unveraendert.

Verifiziert mit dev_cr27_probe (16/16, darunter eine komplett
durchgespielte Partie mit Aufdecken bis zum River und Dealer-Wechsel ueber
alle Haende) und einem Boot-Check ueber sieben Szenen; Sonde vor dem Commit
geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 20:33:48 +02:00

147 lines
9.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ROADMAP.md — Windgeschworen
> Gewichtete Umsetzungs-Reihenfolge über den offenen Backlog aus
> **CHANGEREQUESTS.md**. Dieses Doc ordnet nur — die verbindlichen Details je CR
> stehen weiter in CHANGEREQUESTS.md, der Kanon in SPEC > STORY > WELT. Erledigte
> CRs wandern nach CHANGEREQUESTS_DONE.md; dann hier den Status nachziehen.
>
> Stand: **2026-07-21**. Erledigt: Phasen 0–11, CR 1–8 (8a–8e), CR 11–23 —
> **Wellen 0–3 und die Politur-Welle komplett**. v1 steht inhaltlich und ist
> rundgeschliffen. Offen: der Primitiven-Austausch **CR 24** (Folge-Schritt
> aus CR 23), danach Welle 4 (Akt 2: CR 9/10/8-magie/CR-16-Camp) und das
> eigene Kartenspiel (Stretch).
## Leitprinzip der Reihenfolge
Erst **Entscheidungs-Blocker räumen** (billig, schaltet Ketten frei), dann
**kleine isolierte Fixes** (stabilisieren den Build), dann den **großen
Kampf-Track** (höchstes Risiko, berührt viele v1-Systeme), dann **Flavor/Content**
auf fertigen Systemen, zuletzt die **Akt-2-Features** (jenseits v1).
## Kritischer Pfad
Der ursprüngliche Bau-Pfad (kleine Fixes → CR-8-Bau → Flavor) ist **vollständig
durchlaufen**; v1 steht inhaltlich.
**Jetzt: Politur-Welle** (CR 17–22 aus dem Akt-1-Testdurchlauf; CR 20 erledigt) — v1 rundschleifen,
bevor Akt 2 aufgemacht wird.
**Danach ist der Engpass kein Code, sondern Story:** **Akt 2 ist in STORY.md §9
ausdrücklich „noch auszuarbeiten"**. CR 9 (Bindungs-Achse), CR 10 (Drachenpflege)
und CR 8-magie hängen alle daran — ohne ausgearbeiteten Akt 2 lässt sich ihr Inhalt
nicht sinnvoll spezifizieren. **Welle 4 beginnt also mit Autoren-Arbeit**, nicht
mit Umsetzung.
---
## Welle 0 — Entscheiden & Fundament (PM/Planung) — ✅ erledigt
Reine Doc-/Design-Arbeit, kein Code. Beide Blocker sind geräumt:
- **CR 6 — zweite Siegelkraft.** ✅ Entschieden & ausspezifiziert (Roberts geheime
Kraft: gerade Verstorbene im 5–10-Min-Fenster zurückrufen; CHANGEREQUESTS §6).
Umsetzung → Welle 1.
- **CR 8 — Scope geschärft.** ✅ In **Sub-CRs 8a–8e** zerlegt (+ 8-magie für Akt 2),
alle Autoren-Entscheidungen gesetzt (Encounter-Zonen statt Welt-Sandbox;
Grammatik leicht/schwer/Ausweichen/Dodge/Magie/Kombo; Waffenskill pro Waffe ohne
Rohschaden-Bruch; Permadeath raus → CR 16). Details: CHANGEREQUESTS §8.
## Welle 1 — Kleine isolierte Stabilisierer — ✅ erledigt (2026-07-19)
- **CR 6 — Umsetzung des Zweitsignets** (Entscheidung steht, s. Welle 0). Klein,
weil in v1 nur latent: beim Dreschen zusätzlich zum regulären Siegelkraft ein
**fixes, geheimes zweites** hinter eigenem Flag setzen (nicht im normalen
Reveal zeigen), Daten für Roberts Kraft anlegen, Xaden-erkennt-es-Beat
(STORY §5). Betrifft `hatching_grounds.gd` + `signet_system.gd`.
- **CR 5 — Tyrveil ins Vierte Geschwader / Violets Staffel.** Klein,
self-contained. Staffel-Kameraden Violet/Rhiannon/Ridoc/Sawyer/Liam,
Staffelführer Dain; wirkt auf Formationen, Sparring-Paarungen, Staffel-Ansehen.
- **CR 14 + CR 15 zusammen — Karten-Cluster.** Aula (Gathering Hall) bauen +
verwaiste Schlafsaal-Tür entfernen (CR 14); Hub-Tor-Anordnung an die
Basgiath-Karte angleichen, Lehrtrakt-Bündelung (CR 15). Maßgeblich ist der Text
in ORTE.md, nicht das Referenzbild. **CR 14 ist Voraussetzung für CR 13.**
- **CR 16 — Permadeath raus → Speicher-/Camp-System.** Permadeath-Verdrahtungen
entkoppeln (Viadukt/Tag-9/Dreschen: „Game Over" → „letzter Spielstand"),
ESC-Menü-Save + Schlafen-Save; Camp erst Akt 2. Sinnvoll **vor** CR 8-Bau, weil
CR 8d ohnehin Tag-9 anfasst.
## Welle 2 — Der große Kampf-Track — ✅ erledigt (2026-07-19)
- **CR 8 — Action-RPG-Kampf-Umbau** nach den Sub-CRs **8a→8b→8c→8d→8e**. Die
dauerhaften Regeln des fertigen Systems stehen jetzt in **SPEC §6,
„Kampfsystem"**. Reichweite = **Encounter-Zonen** (Option B), kein
Welt-Sandbox. Berührt Sparring (ersetzt), Tag-9-Hinterhalt (QTE → echter Kampf),
Movement-Abgrenzung (Viadukt/Gauntlet bleiben Geschicklichkeit). Greybox-First;
gleiche DPR über alle Waffenklassen. **Magie-Kampf (8-magie) erst Akt 2.**
## Welle 3 — Flavor/Content auf fertigen Systemen — ✅ erledigt (2026-07-20)
Setzen auf bereits erledigte Systeme auf (CR 8 nicht nötig).
- ~~**CR 11 — Gefechtskunde-Karte (Devera).**~~ **ERLEDIGT (2026-07-20).**
Klick-Karte mit animierten Truppenbewegungen als `map_question`-Beat im
Unterricht; Buch-1-Zeitfilter eingehalten (Poromiel/Greife offen, Veneni
nur als Anomalien, die mit Wahrheit 1 verzahnen).
- ~~**CR 12 — „Blätter jagen".**~~ **ERLEDIGT (2026-07-20).** Treibende Blätter
im Hof, gefangen mit dem bestehenden Movement; speist Muster-Board und
Lexicon. Vater-Seiten selten und bewusst ohne Wahrheit-2-Enthüllung (eigene
Lexicon-Seite statt Muster-Board).
- ~~**CR 13 — Minispiele mit Einsatz**~~ **ERLEDIGT (2026-07-20).** Poker und
Messerspiel am Spieltisch der Aula, mit Marken, Staffel-Ansehen,
Beziehungswerten und echtem Verletzungsrisiko (Schnelligkeits-Malus). Das
**eigene Kartenspiel** war im CR als Stretch markiert und bleibt offen — es
steht als verschlanktes CR 13 in CHANGEREQUESTS.md.
## Politur-Welle — v1-Feinschliff — teilweise erledigt, Nacharbeit offen
CR 20 (Viadukt-Respawn), CR 18 (Viertes Geschwader), CR 21 (Blätter-Jagd) sind
bei einem zweiten Testdurchlauf des Autors bestätigt gut. **CR 17 (Poker) und
CR 19+22 (Schreibpass) waren zu knapp spezifiziert bzw. zu knapp umgesetzt** —
beim Nachprüfen (2026-07-21) kamen drei neue Findings raus, die den
ursprünglichen Abschluss korrigieren:
- **CR 25** — ein Türwechsel-Absturz, den der Autor beim erneuten Test
gemeldet hat (Verdacht: `zone_trigger.gd`, unbestätigt ohne Stack-Trace).
- **CR 26** — CR 19+22 hat nur 11 von 48 Dialog-Dateien wirklich geprüft (die
11 sind sauber verifiziert), 31 fehlen noch. Ursache: die CR-Formulierung
„Xaden zuerst, dann Violet/Imogen" wurde als „nur diese" statt „Priorität,
aber alle" gelesen.
- **CR 27** — Poker fühlte sich nicht wie Poker an (eine Setzrunde, kein
Kartentausch/-aufdecken). CR 17 hatte nie eine Variante festgelegt.
Autor-Entscheidung: **Texas Hold'em**, ersetzt die CR-17-Umsetzung komplett.
## Welle 4 — Akt 2 (jenseits v1)
Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
- **CR 9 — Bindung als dritte Dialog-Achse** (verdeckter Smàladh-Wert 0–100 →
Siegelkraft-Stärke + Kanalisierungs-Ausdauer).
- **CR 10 — Drachenpflege** (Tagesslot am Flight Field) — speist CR 9.
Ton-Regel: Smàladh duldet Pflege erst, dann schätzt er sie.
- **CR 8-magie — Magie-Ebene des Kampfes** (Siegelkraft/Lesser Magic), verzahnt mit
CR 9. Erst nach der Bindung möglich.
- **CR 16 (Rest) — Camp** außerhalb Basgiaths als Speicher-/Schlafpunkt im Feld.
---
## Statusübersicht
| CR | Titel | Welle | Status |
|----|-------|-------|--------|
| 5 | Staffel/Geschwader-Setup | 1 | erledigt (2026-07-19) |
| 6 | Zweite Siegelkraft | 1 | erledigt (2026-07-19, latent; Ausspielung: Akt 3) |
| 7 | Stehendes Gauntlet-Rad | — | erledigt (2026-07-16) |
| 8 | Kampfsystem Action-RPG (8a–8e) | 2 | **erledigt** (2026-07-19, 8a–8e komplett) |
| 8-magie | Magie-Kampf | 4 (Akt 2) | offen |
| 9 | Bindungs-Achse (Akt 2) | 4 | offen |
| 10 | Drachenpflege (Akt 2) | 4 | offen |
| 11 | Gefechtskunde-Karte | 3 | erledigt (2026-07-20) |
| 12 | Blätter jagen | 3 | erledigt (2026-07-20) |
| 13 | Minispiele (Poker + Messerspiel) | 3 | erledigt (2026-07-20) |
| 13-Rest | Eigenes Kartenspiel | — | offen (Stretch, kein v1-Ziel) |
| 17 | Poker: echte Karten + Figuren am Tisch | Politur | **überholt von CR 27** — Setzrunden-Prototyp fühlte sich nicht wie Poker an, ersetzt durch Texas Hold'em |
| 18 | Viertes Geschwader (Ridoc/Sawyer/Liam/Dain) | Politur | erledigt (2026-07-21) — vier Dialogbäume, vier Figuren im Hof, Staffel-Appell als Gruppenszene; beim Nachtest bestätigt |
| 19 | Stimmen-Schreibpass (Dialoge) | Politur | **teilweise** (2026-07-21) — 11 von 48 Dateien wirklich geprüft und verifiziert; Rest siehe **CR 26** |
| 20 | Viadukt-Respawn-Fix (Bug) | Politur | erledigt (2026-07-21) — Respawn am Checkpoint; beim Nachtest bestätigt |
| 21 | Blätter-Jagd (Black-Flag-Gefühl) | Politur | erledigt (2026-07-21) — beim Nachtest bestätigt |
| 22 | Journal/Lexicon-Texte | Politur | erledigt (2026-07-21) |
| 25 | Absturz bei Türwechseln (Bug) | Politur | **in Beobachtung (2026-07-21)** — nicht reproduzierbar (175+ Wechsel sauber); Härtung + Log-Forensik drin, wartet auf nächsten Vorfall mit Log |
| 26 | Schreibpass-Rest (31 Dateien) | Politur | **erledigt (2026-07-21)** — alle 31 geprüft, 15 umgeschrieben nach STIMMEN.md; Fingerabdruck strukturgleich, 17 erledigte Dateien unangetastet |
| 27 | Poker → Texas Hold'em | Politur | **erledigt (2026-07-21)** — Hole Cards, Flop/Turn/River, vier Setzrunden, wechselnde Blinds, Best-of-7-Showdown |
| 23 | Asset-Import-Grundausstattung (Quaternius) | Politur | **erledigt (2026-07-21)** — 296 Modelle sortiert unter `assets/models/`, Rig-Kompatibilität in `scenes/test/asset_pipeline_test.tscn` verifiziert |
| 24 | Primitiven-Austausch in den echten Szenen | Politur | offen — Folge-Schritt aus CR 23, Pipeline steht |
| 25 | Türwechsel-Absturz (Bug) | Politur | offen — Verdacht in `zone_trigger.gd`, Repro + Stack-Trace nötig |
| 26 | Stimmen-Schreibpass fertigstellen | Politur | offen — 31 von 48 Dialog-Dateien noch ungeprüft, vollständige Liste in CHANGEREQUESTS §26 |
| 27 | Poker → echtes Texas Hold'em | Politur | offen — ersetzt CR-17-Umsetzung komplett |
| 14 | Aula-Bau + Tür-Fix | 1 | erledigt (2026-07-19) |
| 15 | Hub-Layout an Karte | 1 | erledigt (2026-07-19) |
| 16 | Permadeath raus → Save/Camp | 1 (Camp: Akt 2) | erledigt (2026-07-19); Camp-Rest: Akt 2 |