Bug-Log & Qualitätsprozess

Zwischen Ahoiiiiiiii (menschlicher Kurator) und Geniestreich (KI‑Cokurator/Assistenz / Skript‑Generator) dient das Bug-Log als gemeinsamer Qualitätskompass.

Ziele

• Vollständige Sichtbarkeit aller inhaltlichen Auffälligkeiten.
• Priorisierung: FATAL → ERROR → WARN → INFO.
• Phasenübergreifende Trendanalyse (Reduktion offener Punkte).

Struktur

• Markdown-Bug-Log (menschliche Lesbarkeit).
• Assistant-JSON (maschinenlesbar) für Triage, AI_HELP Markierungen, Automatisierung.
• Kategorien (z. B. Quellenverzeichnis, Kapitel, Abgleich, Qualität).

Arbeitszyklus

1. Lauf (Phase angemessen wählen).
2. Bug-Log lesen → offensichtliche Fatals/Errors beheben.
3. Triage (Setze einzelne Einträge auf AI_HELP, DEFERRED).
4. Unterstützungs-Skripte generieren Patches oder Vorschläge.
5. Erneuter Lauf → erledigte Einträge verschwinden → Status FIXED.

Metriken

• Anzahl offener Fatals/Errors je Lauf.
• „URL-Abdeckung“: Anteil Referenzen mit URL.
• „Quickinfo-Kürze“: Anteil unter maxQuickinfoLength.
• Delta-Bug-Log: Neu vs. Behoben vs. Persistierend.

Qualitätsregeln

• Keine Teilmutationen bei Fatals in betroffener Datei.
• Lauf immer vollständig abschließen, bevor reales Fixing startet.
• Konsistenz der Terminologie überwachen (Glossar).

Revisionen:

• 2025-11-09 Initialfassung
• 2025-11-09 Terminologie vereinheitlicht