2026 년 5 월 28 일

• 프로젝트 생성
• 귀농 게임 컨셉 정리
• 게임 에셋 수집 및 다운로드 완료 (132 개 PNG)
  • GitHub 레포 클론: GuardianofNature, FarmLands, Sproutville, OldTownFarm, claude-farmer
  • 출처: Sprout Lands (Cup Nooble, CC0), SpriteCook (CC0), Kenney (CC0), CraftPix (Free License)
  • 에셋 분류: characters (26 개), tiles (19 개), objects (36 개), ui (31 개)
  • 모두 상업적 이용 가능
• CI/CD 파이프라인 세팅: GitHub Actions + reviewdog + ESLint + actionlint
  • ESLint v9 flat config 마이그레이션 (.eslintrc.json → eslint.config.js)
  • reviewdog fail_level 버그 수정 (errors → error)
  • CodeRabbit AI PR 리뷰 — 모든 체크 통과 (5/5 ✅)
  • CodeFactor 연동 완료 — 코드 점수 (A~F) 자동 평가
• AI 도구 연동: CodeRabbit + Qwen Code (RunPod self-hosted)
• LLM: Qwen 3.6 35B (RunPod) 로 개발 진행
• 개발 회고: docs/retrospectives/2026-05-28.md

에셋 구조

assets/
├── characters/    - 캐릭터, 동물 스프라이트
├── tiles/         - 타일셋 (지면, 물, 건물, 환경)
├── objects/       - 가구, 작물, 나무, 도구
├── ui/            - 버튼, 대화상자, 아이콘, 마우스 커서
├── music/         - BGM (미정리)
└── sfx/           - 효과음 (미정리)

Godot 공식문서 RAG 데이터 준비

Godot 3/4 판별기와 향후 Qwen 기반 Godot 코딩 모델 학습을 위해 공식 문서 기반 RAG 데이터를 별도로 구축했다. 목표는 LLM이 라벨을 임의로 결정하는 구조가 아니라, 공식 문서에서 나온 근거 청크와 시스템 룰을 기반으로 라벨 후보를 만들고 LLM은 설명/수정 코드/학습 데이터 생성 보조만 맡게 하는 것이다.

관련 문서는 다음 위치에 모은다.

• docs/README.md: 문서 디렉토리 인덱스
• docs/research-notes/: 설계 메모와 데이터 생성 구조
• docs/roadmaps/: 전체 개발 로드맵
• docs/retrospectives/: 날짜별 회고
• work/godot_rag/: 현재 비움. RAG 청킹/후처리 산출물은 제거됨
• outputs/godot_docs_full/: Godot 공식문서 크롤링 결과

관련 회고:

• docs/retrospectives/2026-06-17-godot-rag-judge.md
• docs/retrospectives/2026-06-18-godot-rag-reset.md

Source Data

RAG에 사용할 공식문서 원본은 다음 경로다.

outputs/godot_docs_full/pages

outputs/godot_docs_stable은 중간 복구 폴더라 RAG 기준 데이터로 사용하지 않는다.

최종 수집 검증:

Official search index target pages: 1568
Collected markdown pages: 1570
Missing pages: 0
Failed fetches: 0

2개가 더 많은 이유는 @GDScript, @GlobalScope의 URL 인코딩 alias가 함께 수집되었기 때문이다.

Chunking Status

6월 17일에 생성했던 RAG 청킹/후처리/카탈로그 산출물은 6월 18일에 기준선에서 제거했다.

제거한 범위:

v1 docs_chunks.jsonl
v2 docs_chunks_v2.jsonl
v3/v3.1 catalog/index/mapping 산출물
청킹/후처리/검증 초안 스크립트
초기 chat/index 초안

제거 이유:

원본 공식문서 구조를 충분히 분석하지 않은 상태에서 청킹을 진행했다.
LLM에게 청킹과 후처리를 맡기면서 중간 판단이 불투명해졌다.
일부 API를 핵심 MVP로 간주하거나 하드코딩하는 방향으로 흐르면서 전체 문서 기반 RAG 목적이 흔들렸다.
결과적으로 청크 품질, 메타데이터, catalog 신뢰도를 별도로 검증하기 어려운 상태가 되었다.

다음 작업은 새 청크를 바로 만드는 것이 아니라, outputs/godot_docs_full/pages 원본 문서의 실제 구조를 먼저 분석하는 것이다.