2026년 6월 18일 목요일2026 년 6 월 18 일
- 어제 카페에서 커피를 1리터 정도 마셨더니 오늘따라 상태가 매우 안 좋아 코딩을 제대로 하지 못했음
- 6월 17일에 만든 Godot RAG 청킹/후처리 산출물을 기준선에서 전부 제거함
- v1
docs_chunks.jsonl, v2 docs_chunks_v2.jsonl, v3/v3.1 catalog/index/mapping 산출물 삭제
- 청킹/후처리/검증 초안 스크립트와 초기 RAG chat/index 초안도 함께 삭제
work/godot_rag/는 현재 비워두고, 잘못된 산출물을 기준선으로 삼지 않도록 정리
- 정리 이유를 회고로 기록함
- 원본 공식문서 구조를 충분히 분석하기 전에 청킹부터 진행한 것이 문제였다고 판단
- Godot 공식문서 전체를 근거로 삼으려던 목표가, LLM이 임의로 잡은 “MVP 핵심 API”와 하드코딩/과보강 방향으로 흐르며 오염되었다고 정리
- 내가 지시하지 않았는데 ChatGPT/Codex가 범위를 임의로 줄이거나, 스텝이 끝나기 전에 답이 있다고 가정하고 다음 산출물을 만들어버리는 현상이 있었다고 명시
- LLM 생성물, regex 후보, 공식문서 근거, 사용자가 승인한 규칙의 provenance가 섞이면 라벨러/RAG 판별기 기준으로 쓸 수 없다고 정리
- 현재 아키텍처의 부족한 점을 다시 기록함
- 정적 분석 계층이 약함
- GDScript AST/파서 기반 검증이 없음
- Godot 프로젝트 의존성 그래프가 약함
- 실행/문법 검증이 약함
- 라벨 taxonomy가 아직 뭉툭함
- LLM 생성물과 검증된 정답의 provenance 구분이 약함
- 데이터 누수/중복 제거 설계가 약함
- 다음 작업 방향을
godot_docs_full 원본 분석으로 재설정함
- 바로 RAG나 catalog를 다시 만드는 것이 아니라
outputs/godot_docs_full/pages 자체를 먼저 분석하기로 함
- class reference, migration, tutorial 문서가 각각 어떤 Markdown 구조를 갖는지 확인해야 함
- Godot 공식문서 구조에 맞춰 페이지 단위, 섹션 단위, API 멤버 단위 중 어떤 청크 단위를 쓸지 다시 설계해야 함
- 청킹 전에 검증 리포트 기준을 먼저 정의해야 한다고 정리
- 개발 회고: docs/retrospectives/2026-06-18-godot-rag-reset.md