Ingest 체크리스트

LLM 에이전트가 새 소스를 위키에 ingest할 때 이 체크리스트를 사용합니다.

1. 소스 준비

• 소스 파일이 raw/ 아래에 저장되어 있는지 확인합니다.
• raw 파일은 제자리에서 수정하지 않습니다.
• 나중에 소스를 식별할 수 있도록 제목, 날짜, 출처 같은 기본 맥락을 남깁니다.
• 저장소에 README, PROJECT_STATUS, spec, HANDOFF, CHANGELOG, TODO가 함께 있다면 우선순위를 나눠 읽습니다.
• 기본 source: README, PROJECT_STATUS, spec
• 보조 source: HANDOFF, CHANGELOG
• 참고 메모: TODO

2. 읽기 및 판단

• 위키를 수정하기 전에 소스를 끝까지 읽습니다.
• 핵심 주장, 유용한 사실, 열린 질문, 연결될 가능성이 높은 페이지를 식별합니다.
• 이 소스가 요약 페이지 하나로 충분한지, 아니면 개념/엔티티/비교 페이지까지 갱신해야 하는지 판단합니다.
• HANDOFF는 현재 상태, 읽기 순서, 핵심 결정, 남은 이슈를 압축한 문서로 보고 source 또는 synthesis 갱신에 활용합니다.
• CHANGELOG는 최근 섹션만 선택적으로 읽어 "무엇이 실제로 바뀌었는가"를 확인하는 용도로 씁니다.
• TODO는 미구현 계획과 아이디어가 섞이므로, 사실 요약보다 용어 후보 발굴이나 운영 메모 보강에만 제한적으로 사용합니다.

3. 소스 요약 생성 또는 갱신

• wiki/templates/source-summary-template.md에서 시작합니다.
• 요약 문서는 wiki/ 아래에 소문자 kebab-case 파일명으로 저장합니다. 예: wiki/source-example-title.md
• 간결한 요약, 핵심 주장, 상호 링크, raw 파일 경로를 포함합니다.

4. 관련 위키 페이지 갱신

• 소스가 개념의 framing을 바꾸면 개념 페이지를 추가하거나 수정합니다.
• 소스가 중요한 사람, 조직, 제품, 장소를 소개하면 엔티티 페이지를 추가하거나 수정합니다.
• 비교 또는 분석 페이지는 기존 합성을 실질적으로 개선할 때만 추가합니다.

5. 탐색과 기록 동기화

• 새 페이지를 index.md의 올바른 섹션에 추가합니다.
• log.md에 ingest 내용과 변경 파일을 기록하는 항목을 추가합니다.
• index.md, log.md, 위키 페이지 수정은 같은 변경 단위로 묶습니다.

6. 최종 검토

• 링크가 정상적으로 연결되는지, 페이지 제목이 파일명 목적과 맞는지 확인합니다.
• 각 주장이 소스로 뒷받침되는지, 아니면 합성 해석인지 분명히 구분합니다.
• TODO 기반 내용은 확정 사실처럼 서술하지 않았는지 다시 확인합니다.
• raw 소스가 변경되지 않았는지 확인합니다.
• 큰 추측성 재작성보다 작은 단위의 검토 가능한 수정을 선호합니다.