Karpathy LLM Wiki 패턴 — 한국어 지침

출처: Andrej Karpathy, "LLM Wiki" Gist (원전 영문 · 한국어 번역) 이 문서는 본 LLMWiki 프로젝트(AI 선용 LLMWiki)의 가장 중요한 설계·운영 기준이다. 모든 결정·규칙·하위 카드는 이 패턴과 충돌할 수 없다.

요약

LLM이 점진적으로 구축·유지하는 지속형 위키(persistent wiki) 를 만든다. RAG처럼 매 질의마다 원문을 다시 검색하지 않고, 한 번 컴파일해 누적한다. 사람은 source 큐레이션·탐색·질문에만 집중하고, 위키 작성·교차참조·유지보수는 LLM이 전담한다. 3계층(Raw sources · The wiki · The schema) 만 갖추면 작동한다.

핵심 차별점:

• 위키는 지속적·복리 누적 아티팩트 — 교차참조·모순·종합이 매번 새로 만들어지지 않고 이미 존재
• LLM이 쓰고 사람이 읽는다 — 사람은 source 큐레이션·탐색·질문에만 시간을 씀
• 유지보수 비용 거의 0 — LLM은 지루해하지 않고 한 번에 15개 파일도 건드림 → 위키가 유지됨
• Compilation ≠ RAG — 한 번 구조화 후 누적, 매번 발굴 안 함

상세

3계층 아키텍처

본 프로젝트(wiki_AI_선용)에서의 매핑:

• Raw sources → 10 LLMwiki/sources/ (A_sermon~F_news 카테고리)
• The wiki → 10 LLMwiki/wiki/ (entity·concept·procedure·domain·case·term·synthesis + 확장 article·thesis·plan)
• The schema → 10 LLMwiki/WIKI_CLAUDE.md (LLMwiki_init SSOT 복사본, 수정 금지)

적용 영역

Karpathy가 언급한 5가지 + 본 프로젝트 맥락:

본 프로젝트의 핵심: 교회 사역에서 AI를 선용하는 정체성·가드레일을 3축 엔지니어링 관점으로 누적·서비스화.

운영(Operations) — 3가지 작업

1. Ingest (투입)

새 source 1개 → 위키 페이지 10~15개 갱신.

표준 흐름 (본 프로젝트 적용):

1. 사용자가 90 입력 자료(INPUT)/9XXX [한글]/.../<slug>.md 에 raw md 정착 (/wiki수집 자동) 또는 sources/<카테고리>/YYYY-MM-DD_<slug>.md 직접 투입
2. LLM이 source를 읽고 핵심 요지를 사용자와 논의
3. wiki/synthesis/ 에 요약 페이지 작성
4. wiki/index.md 갱신 (새 카드 카탈로그 항목)
5. 관련 entity/·concept/·term/ 페이지 갱신 (10~15장)
6. wiki/log.md 에 ingest 엔트리 append
7. graph/index.json 재생성 (D3.js Force Graph 피드)

본 프로젝트 자동화: A03.01 wiki-ingest 에이전트 + llmwiki-ingest 스킬.

2. Query (질의)

질의 흐름:

1. wiki/index.md 먼저 읽기 — 전체 카탈로그 파악
2. 관련 페이지로 drill-down
3. 답변에 인용한 페이지는 [type/slug](/type/slug/) wikilink로 표시
4. 좋은 답변은 새 페이지로 다시 파일링 — wiki/synthesis/ 또는 적절한 타입에 환원

답변 포맷 후보: 마크다운 페이지·비교 표·Marp 슬라이드 덱·matplotlib 차트·캔버스.

본 프로젝트 핵심: 사용자 질의 답변이 카드뉴스·칼럼·소책자·PPT 형태로 환원될 때는 type/article 하위(card-news/column/booklet/ppt)로 파일링.

3. Lint (건전성 점검)

주기적 위키 건강 검진. 살필 항목:

• 페이지 간 모순
• 최신 source로 대체된 오래된 주장
• 들어오는 링크 없는 고아(orphan) 페이지
• 언급만 되고 자체 페이지가 없는 중요 개념
• 빠진 교차참조
• 웹 검색으로 메울 수 있는 데이터 공백

LLM은 다음을 잘 함: 새 질문 제안·찾아볼 source 제안.

본 프로젝트 자동화: A06.02 performance-auditor (주간) + A06.03 dag-validator + A06.04 log-janitor.

두 특수 파일 — index.md & log.md

중간 규모(~100 source, 수백 페이지)까지 index.md만으로 충분 — 임베딩 기반 RAG 인프라 불필요.

선택 도구

• 검색 엔진: qmd (BM25 + 벡터 + LLM 재순위, on-device, CLI + MCP). 위키가 작으면 index.md 만으로 충분.
• Obsidian Web Clipper — 웹 기사를 md 변환해 sources 직투입.
• Obsidian Graph View — 위키 형태(허브·고아) 시각화.
• Marp — 마크다운 슬라이드 (본 프로젝트 PPT 산출물에 직접 활용 가능).
• Dataview — frontmatter 쿼리 (본 프로젝트 [_views/ministry], [_views/ai] 에서 사용).
• Git — 위키는 단지 md 파일의 git 레포 → 버전·브랜치·협업 자동.

방법론

본 프로젝트에 적용하는 7가지 불변 규약 (L0 Karpathy Canon)

본 ../WIKI_CLAUDE.md 의 Canon 7조와 1:1 일치:

1. sources/는 절대 수정·삭제 금지. LLM은 읽기만.
2. sources/ 파일명은 YYYY-MM-DD_<topic-slug>.<ext>.
3. wiki/에 index.md와 log.md 가 반드시 존재.
4. WIKI_CLAUDE.md 가 위키 관리자 모드 진입 스키마.
5. Query는 항상 index.md 먼저 → drill-down.
6. 페이지 간 참조는 wikilink ([type/slug](/type/slug/)) 만. URL·상대경로 금지.
7. sources/만 있으면 wiki/ 전체를 언제든 재컴파일 가능해야.

본 프로젝트 강화 규약 (도메인 특화)

Karpathy 원전이 "추상적"이라 명시했으므로, 본 프로젝트는 다음을 추가:

• 신학·교리 표현은 사용자 검증 후 승격 (A04.04 doctrine-sidecar 자동 게이트)
• 성경 인용은 우리말성경 우선 (글로벌 B2KG 101_우리말성경/ 참조)
• 3축 자동 태깅 (A02.05 three-axis-tagger): 프롬프트·컨텍스트·하네스 엔지니어링 분류
• 출력 한글 우선 — 영문 source도 wiki 카드는 한국어로 컴파일
• 9001/900101 입력 스테이징 — 90 입력 자료(INPUT)/ 단계에서 사용자 검토 후 sources/ 승격 (Karpathy Canon은 sources만 다루고 그 전 단계는 본 프로젝트가 추가한 staging 레이어)

대비 — RAG vs LLM Wiki

주의사항

자주 하는 실수 (본 프로젝트가 피해야 할 것)

• WIKI_CLAUDE.md를 프로젝트 맥락으로 수정 → 금지. SSOT는 LLMwiki_init/WIKI_CLAUDE.md. 프로젝트 고유 규칙은 [10 LLMwiki/../CLAUDE.md] 또는 본 카드에 기록.
• subdomain 폴더 생성 (예: wiki/ministry/) → 금지. subdomain은 frontmatter + _views/ Dataview 뷰.
• sources/ 파일을 사후 수정 → 금지. 수정이 필요하면 새 source 추가 후 기존 링크는 status: deprecated로.
• Wiki Card 파일명에 날짜 접두사 → 금지. 날짜는 created frontmatter로. sources/만 날짜 접두사.
• 필수 6 필드 누락 상태에서 verified 승격 → 금지. 누락 시 영구 status: draft.
• 본 프로젝트의 자동 출력은 항상 status: draft·visibility: private — 사람이 검증 후 승격 (특히 신학·교리).

Karpathy 원전이 명시한 한계

• 위키 자체는 abstract idea — 정확한 디렉토리 구조·schema 관례·페이지 포맷·도구 선택은 도메인별로 다르다
• 모든 옵션 도구(검색·Marp·Dataview·이미지 다운로드)는 선택 사항이며 모듈식 — 필요한 것만 채택
• LLM은 인라인 이미지가 있는 마크다운을 한 번에 읽지 못함 — 본문 먼저 읽고 이미지를 별도 열람하는 워크어라운드 필요

본 프로젝트 추가 한계

• sources/ 카테고리(A_sermon~F_news)는 본 프로젝트 도메인 특화 — 다른 LLMWiki 프로젝트는 다른 카테고리일 수 있음
• 90 입력 자료(INPUT)/9XXX/9XXXNN/ 스테이징 레이어는 본 프로젝트만의 추가 레이어 — Karpathy 원전에는 없음 (사용자 자료를 묶음으로 가져올 때 검토 큐 역할)
• A07.04 ministry-plan-builder의 사역별 실무 계획 지침은 본 프로젝트 고유 산출물 (type/plan)

관련 카드

• concept/raw-sources-immutable — sources/ 불변성 상세
• concept/wiki-llm-managed — wiki/ LLM 소유 원칙
• concept/wiki-claude-schema — WIKI_CLAUDE.md 스키마 역할
• concept/index-first-query — index.md 먼저 읽기 규약
• concept/wikilink-internal-only — [type/slug](/type/slug/) 형식만 허용
• concept/recompilation-canon — sources만 있으면 wiki 재컴파일 가능
• entity/andrej-karpathy — 패턴 제안자
• entity/vannevar-bush-memex — 1945년 정신적 선조
• procedure/wiki-ingest-pipeline — Ingest 운영 절차

(위 wikilink 중 일부는 미생성 — 향후 컴파일 대상)

출처

• 영문 원전: source/E_research/karpathy-llm-wiki-gist-en (Karpathy 2026-04 Gist 전문, MIT 라이선스 추정)
• 한국어 번역: source/E_research/karpathy-llm-wiki-gist-ko (Claude 번역, 2026-04-21)
• LLMwiki_init 축약본: LLMwiki_init/sources/2026-04-21_karpathy-llm-wiki-pattern.md
• 컴파일된 LLMwiki_init 카드: LLMwiki_init/wiki/concept/llm-wiki-compilation.md
• 본 프로젝트 표준 정의: Code_init DG030014_SNLW_*.md + DG030015_LLMWiki_통합_마크다운_표준_지침서.md