idea_world_labDEV JOURNAL
2026年6月18日木曜日

2026 年 6 月 18 日

  • 昨日カフェでコーヒーを約 1 リットル飲んだら、今日は状態が非常に悪くなり、コーディングがままならなかった
  • 6 月 17 日に作成した Godot RAG チャンキング/後処理成果物を基準線からすべて削除した
    • v1 docs_chunks.jsonl、v2 docs_chunks_v2.jsonl、v3/v3.1 カタログ/インデックス/マッピング成果物を削除
    • チャンキング/後処理/検証草案スクリプトと初期 RAG chat/index 草案も一緒に削除
    • work/godot_rag/ は現在空にして、誤った成果物を基準線にしないよう整理
  • 整理理由を回顧として記録した
    • 元の公式ドキュメント構造を十分に分析する前にチャンキングを進めたことが問題だったと判断
    • Godot 公式ドキュメント全体を根拠にしようとした目標が、LLM が任意に取った “MVP コア API” とハードコーディング/過剰強化方向に流れ、汚染されたと整理
    • 私が指示しなかったのに ChatGPT/Codex が範囲を任意に縮小したり、ステップが終わる前に答えがあると仮定して次の成果物を作り出す現象があったと明記
    • LLM 生成物、正規表現候補、公式ドキュメント根拠、ユーザーが承認した規則の provenance が混在するとラベラー/RAG 判別器の基準として使えないと整理
  • 現在のアーキテクチャの不足点を再記録した
    • 静的解析層が弱い
    • GDScript AST/パーサベースの検証がない
    • Godot プロジェクト依存性グラフが弱い
    • 実行/文法検証が弱い
    • ラベルタクソノミーがまだ粗い
    • LLM 生成物と検証済み正解の provenance 区別が弱い
    • データ漏洩/重複除去設計が弱い
  • 次の作業方向を godot_docs_full 原本分析に再設定した
    • すぐに RAG やカタログを作り直すのではなく、outputs/godot_docs_full/pages 自体を先に分析することにした
    • class reference、migration、tutorial 文書がそれぞれどのような Markdown 構造を持つか確認する必要がある
    • Godot 公式ドキュメント構造に合わせて、ページ単位、セクション単位、API メンバー単位のどのチャンク単位を使うか再設計する必要がある
    • チャンキング前に検証レポート基準を先に定義すべきだと整理
  • 開発回顧: docs/retrospectives/2026-06-18-godot-rag-reset.md