cmds-llm-wiki — Karpathy LLM Wiki Template

Overview

RAG 는 질문마다 문서를 검색·재합성합니다. LLM Wiki는 다릅니다 — LLM 이 자료를 한 번 읽고 structured wiki 로 컴파일하고, 새 자료가 올 때마다 incremental update. 결과물은 점점 더 풍부해지는 compounding knowledge base.

"The tedious part of maintaining a knowledge base is not the reading or the thinking — it's the bookkeeping." — Andrej Karpathy, LLM Wiki Gist (2026-04-06)

이 템플릿에 포함된 것

3-Layer Architecture

Raw Sources (불변) → Wiki (LLM 관리) → Schema (CLAUDE.md). Karpathy 원래 제안 그대로.

미래의 나에게 보내는 편지 정책

/ingest 시 미래의 나에게 편지를 남기듯, 왜 수집했고 어디에 쓸지 한 줄 기록. 수집은 미래의 나와 하는 대화.

Claude Code Harness

7 slash commands + 2 PostToolUse hooks + 18 Web Clipper JSON 템플릿. 3년 운영 실전에서 검증.

Core Context

사용자 정체성 · 7 재활용 축 · 철학을 한 노트에 외재화. 모든 operation 전에 LLM 이 로드.

Contamination Mitigation

kepano (Obsidian CEO) 제안 — 에이전트 playground 와 개인 PKM 분리. Satellite vault 로 독립 운영.

3-Layer Architecture

각 계층은 소유자와 규칙이 다릅니다. 이 분리가 깨지면 harness 가 무너집니다.

Schema Layer 인간+LLM

CLAUDE.md + Core Context.md + .claude/commands/ — LLM 의 행동 규칙. harness 의 단일 source of truth.

Wiki Layer LLM 관리

20. Wiki/ — Concepts, Entities, Guides, Maps (MOC). LLM 이 자유 편집. cross-reference, 모순 플래그, incremental update.

Raw Sources Layer 불변

10. Raw Sources/ — 원본 보존. ## Original Content 섹션 verbatim 강제 (PostToolUse hook). LLM 은 읽기만.

RAG vs LLM Wiki

축적 RAG

축적 Wiki ✓

인프라 RAG

인프라 Wiki ✓

LLM Wiki 는 벡터 DB 없이 마크다운 파일만으로 작동. 검색은 qmd (BM25 + 벡터 하이브리드).

7 Slash Commands

.claude/commands/ 에 markdown 으로 정의. 모든 interactive command 는 Core Context 를 prerequisite 로 로드.

/ingest PURPOSE-GATED

소스 (URL/파일/텍스트) → Raw Source 저장 + Wiki 10~15 페이지 업데이트. Step 0 에서 목적 질문 강제, Step 0-a 에서 mothership 자동 cross-link 검색.

/inbox BATCH

00. Inbox/ 스캔 후 배치 처리. 모드: single-axis (전체 동일 목적) / per-file (파일별) / auto-infer (LLM 추론).

/query SYNTHESIS

Wiki 검색 → 답변 합성 → gap/contradiction 역피드백. 7 재활용 축 매칭 + reusableFor 기록.

/lint WEEKLY

9-step 건강도 체크 — orphan / broken links / contradictions / v2 frontmatter coverage / Core Context freshness.

/status DASHBOARD

카운트 + collectionPurpose coverage % + Core Context age + Inbox 백로그.

/reindex TECHNICAL

qmd 수동 재인덱싱. PostToolUse hook 이 자동 처리하지만 Obsidian 직접 편집 후 수동 필요.

/refresh-context MONTHLY

Core Context 재snapshot. Mothership 변경 / 새 에세이 / 30일+ 오래된 snapshot 시 실행.

/ingest 실행 예시

# URL 하나로 시작
$ /ingest https://gist.github.com/karpathy/...

# Step 0 — 목적 질문
"이 소스를 왜 수집하셨나요? 7 재활용 축 중 어디에?"
→ (5) CMDS 시스템 — Karpathy 원문 확인

# Step 0-a — mothership 검색
✓ Found 3 related notes in mothership

# Step 1-6 — 컴파일
✓ Raw Source saved
✓ 10 wiki pages created/updated
✓ log, index synced

2 PostToolUse Hooks

.claude/settings.json 에 등록. Write/Edit 후 자동 실행.

validate-raw-source.sh BLOCKING

Raw Source 저장 시 ## Original Content 섹션 검증. 없거나 20줄 미만이면 exit code 2 — Claude 에게 수정 강제. LLM 이 요약으로 덮어쓰는 실수 방지.

qmd-reindex.sh NON-BLOCKING

Wiki/Raw/Query 저장 시 qmd 자동 재인덱싱. 8초 debounce. 백그라운드 실행으로 세션 블로킹 없음.

settings.json

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit|MultiEdit",
      "hooks": [
        { "type": "command",
          "command": ".claude/hooks/validate-raw-source.sh" },
        { "type": "command",
          "command": ".claude/hooks/qmd-reindex.sh" }
      ]
    }]
  }
}

미래의 나에게 보내는 편지

수집은 미래의 나와 하는 대화다. 지금 이 소스를 수집하는 이유와 맥락을 한 줄로 남기지 못한다면, 미래의 나는 이 자료를 왜 모았는지 기억하지 못한다.

"수집은 미래의 나에게 보내는 편지다. 왜 이걸 모았는지, 어디에 쓸 건지 — 한 줄이면 충분하다. 그 한 줄이 없으면 맥락 없는 파편이 된다."

7 재활용 축 (예시 — 사용자가 직접 정의)

PhD 연구 — 학위 논문, 선행문헌

학술 출판 — 저널 논문, 학회 발표

강의 · 강연 — 대학 수업, 기업 교육

컨설팅 — 기업 AI 전환 프로젝트

시스템 개선 — start-kit, 플러그인

에세이 · 브랜딩 — 블로그, 뉴스레터

제품 · 플러그인 — 소프트웨어 개발

v2 YAML Frontmatter Keys

collectionPurpose

수집 목적 (필수). Step 0 답변 그대로 기록.

mainVaultRelated

(옵션) mothership vault 에서 찾은 연결 노트 2~5개.

mainVaultCmds

(옵션) mothership CMDS 카테고리.

reusableFor

(옵션) Query Result 가 7 축 중 어디에 쓰일지.

Core Context

모든 /ingest /query /lint 전에 LLM 이 먼저 읽는 사용자 맥락 노트. 이것 없이는 모든 operation 이 "목적 없는 자동 정리" 로 전락.

5개 섹션 (채워서 사용)

Who — 정체성

이름, 역할, 전문 분야, 연속성 선언 1~3문장

Why — 7 재활용 축

수집한 지식이 어디에 쓰일지. 미래의 나에게 보내는 편지 기반.

What — 개인 프레임워크 (옵션)

예: CMDS Process (Connect → Merge → Develop → Share)

How — 철학 3~5개 (옵션)

예: "스키마가 문서보다 먼저다", "Harness 설계가 경쟁력이다"

Where — Mothership (옵션)

별도 PKM 볼트가 있다면 시스템 파일 snapshot. 없다면 생략.

"나는 원래 A 를 연구하던 사람이다. 지금 B 를 말할 때도 내가 보는 것은 결국 A 다." — 연속성 선언 템플릿

18 Web Clipper Templates

Obsidian Web Clipper 용 JSON 모음. 브라우저에서 00. Inbox/ 로 직접 캡처.

Web Article News Tech Blog Tech Docs Substack LinkedIn LinkedIn Pulse YouTube Podcast X (Twitter) Threads Reddit Instagram Hackernews GitHub arXiv Selection + Custom

전체 JSON: 90. Settings/Sharing/clipper-*.json
Obsidian Web Clipper → Settings → Templates → Import

Quick Start — 4 Steps

1. Clone

cd ~/DEV
git clone https://github.com/johnfkoo951/cmds-llm-wiki.git my-llm-wiki
cd my-llm-wiki

2. Placeholder 치환

# 본인 값으로 수정 후 실행
LC_ALL=C find . -type f \( -name "*.md" -o -name "*.sh" -o -name "*.yml" \) \
  -not -path "./.git/*" -print0 | xargs -0 sed -i '' \
  -e 's|{your-name}|홍길동|g' \
  -e 's|{Your Name}|Jane Doe|g' \
  -e "s|{PATH_TO_YOUR_LLM_WIKI}|$HOME/DEV/my-llm-wiki|g"

3. Core Context 채우기

Obsidian 에서 Core Context.md 열기 → 정체성 + 재활용 축 채우기 → status: template → status: active

4. 첫 /ingest

claude
# Claude Code 에서:
/status
/ingest https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

GitHub Clone ↗ QUICK-START.md ↗

References

Andrej Karpathy

LLM Wiki pattern — 3-layer 아키텍처, ingest/query/lint 삼박자. Gist ↗

kepano (Steph Ango)

Obsidian CEO — contamination mitigation. 에이전트 playground 와 개인 PKM 분리. @kepano ↗

Yohan Koo · CMDSPACE

3년 운영 경험에서 추출한 harness, hooks, 18 clipper templates. @YohanKoo ↗

자매 레포

cmds-system-files MOTHERSHIP

CMDS mothership PKM 시스템 — 5 core files + Connect→Merge→Develop→Share + 100~900 카테고리. 본 Wiki 를 satellite 로 연결 가능.

GitHub ↗

레포 내부 문서

README.md CHANGELOG.md CLAUDE.md Core Context.md