Laby/docs/05_Tasks_Backlog.md

05 – Tasks & Backlog (Changelog)

Zentrales Log über abgearbeitete Tasks (Changelog) und das offene Backlog. Jeder abgeschlossene Arbeitsschritt an der Test-Suite wird hier als Eintrag dokumentiert – das beantwortet die Frage: „Werden Tasks, die abgearbeitet werden, dokumentiert?" → Ja, hier.

Konvention:

• Chronologisch, neuestens oben.
• Format: ### [YYYY-MM-DD] Kurztitel + Stichpunkte (Geändert / Begründung / Impact).
• Offene Punkte wandern in §3 (Backlog), abgeschlossene in §2 (Changelog).
• Trennung zu CHANGELOG.md: Diese Datei = Task-Changelog (was an der Suite abgearbeitet wurde). Die Versions-Historie des Games + der Suite (z. B. 1.0.2, Versionssprünge) lebt im Root-CHANGELOG.md. Große Changes gehören in beide.

---

1. Status-Snapshot

Bereich	Status
Test-Suite (Audit / Self-Play / Perf / Report)	✅ implementiert & lauffähig
Dokumentation (01–06)	✅ überarbeitet & konsistent
CI-Definition	🟡 dokumentiert (Workflow noch zu commiten)
Refactoring der Game-Datei	🔵 Advisory-Backlog (siehe 06_Refactoring_Game.md)

---

2. Changelog (abgearbeitete Tasks)

[2026-08-28] Doku-Nummerierung vereinheitlicht (01–06)

• Geändert: Drei veraltete Dateien (01_Refactoring_Performance.md, 02_Audit_Bericht.md, 03_Automatisierung_SelfPlay.md) mit altem „Game"-Framing entfernt.
• Neu: Kohärentes Set 01_Debug_API, 02_Audits, 03_Automatisierung_CI, 04_Resultate_Report, 05_Tasks_Backlog, 06_Refactoring_Game.
• Begründung: Repo ist eine Test-Suite, kein Spiel → Doku musste umfokussiert und neu nummeriert werden.
• Impact: Keine Code-Änderung; reine Dokumentation.

[2026-08-28] Schemata gegen echten Code verifiziert

• Geändert: selfplay-results.json, perf-result.json, audit-result.json-Schemata in 03 und 04 an den tatsächlichen Skript-Output angepasst.
• Geändert: CI-Gate prüft jetzt summary.fail statt des nicht existierenden Felds "failed".
• Begründung: Doku-Beispiele kollidierten mit der realen Ausgabe (falsche Feldnamen).
• Impact: CI-Beispiel läuft jetzt konsistent mit audit-result.json.

[2026-08-28] README auf Test-Suite-Framing umgestellt

• Geändert: README beschreibt jetzt das Test-/Audit-Projekt, nicht das Spiel.
• Neu: Hinweis, dass Aegis-Labyrinth.html manuell in die Root gelegt werden muss.
• Begründung: User-Fokus: Suite testet & auditiert die extern eingelegte Game-Datei.
• Impact: Onboarding-Clairity für neue Nutzer.

[2026-08-28] report.mjs als Artefakt-Generator dokumentiert

• Geändert: 04_Resultate_Report.md mit report.html-Aufbau + „no data"-Verhalten.
• Impact: Klare Referenz, was npm run report erzeugt.

---

3. Offenes Backlog

Priorität: P0 = sofort, P1 = kurzfristig, P2 = später. Jede erledigte Aufgabe wandert nach oben in §2 (Changelog) mit Datum.

Test-Suite / CI

#	Prio	Task
1	P0	.github/workflows/ci.yml aus 03_Automatisierung_CI.md commiten & aktivieren
2	P0	Aegis-Labyrinth.html + Test-Artefakte in .gitignore sicherstellen
3	P1	CI-Secret AEGIS_GAME_BASE64 anlegen (Game-Datei in CI bereitstellen)
4	P1	Lighthouse-Job als eigene CI-Stufe ergänzen (Performance-Score ≥ 80)
5	P2	Trend-Tracking: Lauf-Results als CSV/JSON-Artifact archivieren (Trend-Chart)

Robustheit der Skripte

#	Prio	Task
6	P1	Self-Play: deterministischer Seed für Math.random() (reproduzierbare Episoden)
7	P1	Perf-Test: Heap-Delta (vorher/nachher) statt absoluter Werte → Leak-Heuristik
8	P2	Optionaler Q-Learning-/MCTS-Bot (Outline in alter Doku, ggf. neu aufbauen)

Dokumentation

#	Prio	Task
9	P1	01_Debug_API.md um effectTuning/effectLimits-Detailfeld ergänzen, wenn es sich ändert
10	P2	report.html-Screenshot/Beispiel als Referenz in 04 aufnehmen

---

4. How-to: Neue Task dokumentieren

1. Task erledigen (Code / Doku / CI).
2. Oben in §2 einen Eintrag anfügen: ### [JJJJ-MM-TT] Titel + Stichpunkte.
3. Falls noch offen: als Zeile in §3 eintragen, Priorität setzen.
4. Bei Abschluss: aus §3 entfernen und in §2 verschieben.