windgeschworen/docs/ROADMAP.md
danny 37f7ca4e5b CR 25: Tuerwechsel-Crash — Haertung + Forensik, Ursache noch offen
Untersuchung: In vier eskalierenden Reproduktions-Aufbauten (headless direkt,
Doppel-Trigger im selben Frame, windowed, windowed mit echtem
Physik-body_entered und stehender Absage) ueber 175+ Tuerwechsel kein Absturz
und kein einziger Fehlertext. Die Verdachtsstelle aus der CR
(zone_trigger-await) ist in Godot 4.7 nachweislich still: Coroutinen auf
freigegebenen Instanzen brechen stumm ab, gebundene Timer-Signale werden beim
Freigeben getrennt, freigegebene Objekte vergleichen sich gleich null. Die
gesamte freed-instance-Klasse scheidet als Ursache aus. Symptombild laut
Rueckfrage (Fenster minimiert sich, Standbild, wechselnde Tueren) passt zu
einem Stall oder Fokus-Verlust jenseits der Skript-Ebene — das laesst sich
erst mit einem echten Log belegen.

Trotzdem gehaertet, weil beim Suchen zwei echte (stille) Fehler auffielen:
zone_trigger stellt das Absage-Label jetzt ueber einen Kind-Timer statt await
zurueck — kein Zombie-Rest nach dem Wechsel. Und stirbt die Szene unter einem
laufenden Dialog weg (Auto-Start-Szenen wie Appell koennen mit einem
Tuertrigger um denselben Frame rasen), endete der Dialog vorher NIE: die
Autoload-Coroutine hing fuer immer im choose()-Await und legte die Box ueber
die neue Szene. DialogueSystem prueft jetzt pro Frame, ob die Sprecher noch
leben, und beendet den Dialog still; die Box kann eine offene Auswahl von
aussen aufloesen.

Forensik fuer den naechsten Vorfall: Log-Aufbewahrung auf 30 Dateien erhoeht
und jeder Tuerwechsel schreibt eine [tuerwechsel]-Zeile ins Log. Beim
naechsten Standbild die neueste Datei aus
%APPDATA%/Godot/app_userdata/Windgeschworen/logs/ sichern.

CR 25 bleibt in CHANGEREQUESTS.md als IN BEOBACHTUNG stehen. Die
Autoren-Docs dieser Runde (STIMMEN.md neu, SPEC/CHARACTERS-Anpassungen,
CR 25-27) fahren mit diesem Commit ein.

Verifiziert mit einer Regressions-Sonde (5/5: Kind-Timer aktiv, Wechsel mit
stehender Absage sauber, Dialog endet still bei toten Sprechern, 15 weitere
schnelle Wechsel) und einem Boot-Check ueber 13 Szenen; Sonden vor dem Commit
geloescht.

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

9.3 KiB
Raw Blame History

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
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