18. Juni 2026

Gestern habe ich im Café etwa einen Liter Kaffee getrunken, und heute ging es mir sehr schlecht, sodass ich nicht richtig programmieren konnte

Am 17. Juni wurden alle von der Basislinie abgeleiteten Godot‑RAG‑Chunking‑/Nachbearbeitungs‑Ausgaben entfernt

• v1 docs_chunks.jsonl, v2 docs_chunks_v2.jsonl, v3/v3.1‑Katalog/Index/Mapping‑Ausgaben gelöscht
• Entwurfs‑Skripte für Chunking/Nachbearbeitung/Validierung sowie den ersten RAG‑Chat/Index‑Entwurf ebenfalls entfernt
• work/godot_rag/ bleibt vorerst leer, um fehlerhafte Ausgaben nicht als Basislinie zu verwenden

Der Grund für die Bereinigung wurde als Rückblick festgehalten

• Es wurde festgestellt, dass das Problem darin lag, dass das Chunking begonnen wurde, bevor die ursprüngliche offizielle Dokumentationsstruktur ausreichend analysiert war
• Das Ziel, die gesamte offizielle Godot‑Dokumentation als Grundlage zu nutzen, wurde durch „MVP‑Kern‑APIs“, die das LLM willkürlich auswählte, sowie durch Hard‑Coding‑/Über‑Engineering‑Ansätze verwässert
• Es wurde angegeben, dass ChatGPT/Codex eigenständig den Umfang reduzierte oder annahm, dass eine Antwort bereits vor Abschluss eines Schrittes vorlag, und daraufhin weitere Ausgaben erzeugte, obwohl ich das nicht angeordnet hatte
• Wenn die Herkunft von LLM‑Generaten, Regex‑Kandidaten, offiziellen Dokumentationsbelegen und vom Nutzer genehmigten Regeln vermischt wird, können sie nicht als Grundlage für Labeler‑/RAG‑Entscheider verwendet werden

Die Mängel der aktuellen Architektur wurden erneut dokumentiert

• Die statische Analyse‑Schicht ist schwach
• Es fehlt eine GDScript‑AST/Parser‑basierte Validierung
• Der Abhängigkeitsgraph des Godot‑Projekts ist unzureichend
• Laufzeit‑/Syntax‑Validierung ist schwach
• Das Label‑Taxonomie ist noch grob
• Die Unterscheidung der Herkunft von LLM‑Generaten und validierten Antworten ist schwach
• Das Design zur Vermeidung von Datenlecks/Doppelungen ist unzureichend

Die nächste Arbeitsrichtung wird auf die Analyse der Original‑godot_docs_full‑Dokumentation zurückgesetzt

• Statt sofort RAG oder Katalog neu zu erstellen, wird zunächst outputs/godot_docs_full/pages selbst analysiert
• Es muss geprüft werden, welche Markdown‑Struktur die Klassen‑Referenz, Migration und Tutorial‑Dokumente jeweils haben
• Entsprechend der Struktur der offiziellen Godot‑Dokumentation muss neu entschieden werden, ob Chunk‑Einheiten pro Seite, pro Abschnitt oder pro API‑Member verwendet werden sollen
• Vor dem Chunking muss zunächst ein Validierungs‑Report‑Standard definiert werden.

Entwicklungsrückblick: docs/retrospectives/2026-06-18-godot-rag-reset.md