llm-wiki

Karpathy의 LLM Wiki 패턴 (2026-04-04)을 Claude Code 위에서 실전 동작 가능한 형태로 구체화한 프로젝트.

핵심 아이디어

RAG가 아니라 wiki다. RAG는 매 질문마다 raw chunk를 다시 끌어와 답한다. 이 프로젝트는 LLM이 점진적으로 누적되는 markdown 위키를 유지보수한다. 새 소스가 들어오면 단순히 인덱싱하는 게 아니라, 읽고 핵심을 뽑아 기존 위키와 통합한다 — 새 페이지를 만들고, 기존 페이지를 갱신하고, 모순을 표시하고, cross-reference를 더하면서.

사용자는 sourcing/curation/questioning을 한다. Claude는 모든 bookkeeping을 한다.

Obsidian으로 위키를 보면서 Claude Code로 위키를 키워간다.

빠른 시작

2. Claude Code로 진입

SessionStart hook이 위키 현황을 자동 주입한다.

3. 첫 소스 ingest

• 소스를 읽고
• 핵심 takeaway 후보를 사용자에게 제시 → 합의
• wiki/sources/에 1:1 요약 페이지 작성
• 영향받는 entity/concept/topic 페이지 갱신
• wiki/meta/index.md와 log.md 갱신
• 종합 보고

Obsidian 통합 (선택)

이 위키는 그냥 markdown 폴더이므로 Obsidian이 그대로 동작한다.

• Obsidian에서 이 디렉토리를 vault로 열기.
• Settings → Files and links → Use [[Wikilinks]] = ON.
• Settings → Files and links → Default location for new attachments → raw/assets/.
• (선택) Obsidian Web Clipper 확장으로 raw/articles/에 직접 클리핑.

그래프 뷰가 가장 강력한 사용처. 클러스터링과 hub/orphan을 시각적으로 본다.

설계 원칙

1. Three-layer immutability

• raw/ = immutable (hook으로 차단)
• wiki/ = LLM이 소유
• CLAUDE.md = 사용자와 LLM이 공동 소유

2. 항상 사용자 합의 먼저

Ingest 시 takeaway를 합의 없이 위키에 쏟지 않는다. 큰 변경(5+ 페이지)은 plan을 먼저 제시한다.

3. Append-only log

wiki/meta/log.md는 절대 과거 항목을 수정하지 않는다. 위키의 추적성은 git + log.md의 이중 보장.

4. 모순은 보존, 침묵하지 않음

새 소스가 기존과 어긋나면 한쪽을 지우지 않고 ⚠️ Contradiction: 마커로 양쪽을 남긴다. 사용자가 판단.