CMDS LLM Wiki 아키텍처 CMDS LLM Wiki Architecture

Karpathy 의 LLM Wiki 패턴 (2026-04-06) 을 Obsidian + Claude Code 로 구현한 위성 볼트의 종합 문서. 마더십 (CMDSPACE_Local_MBP) 과 짝을 이루는 구조, 3-Layer 패턴, 시스템 파일 6 개의 역할, Living Reference Policy 까지. Comprehensive documentation of the satellite vault implementing Karpathy's LLM Wiki Pattern (2026-04-06) on Obsidian + Claude Code. Covers paired structure with the mothership, 3-Layer pattern, 6 system files, and Living Reference Policy.

개요Overview

CMDS LLM Wiki 는 외부 자료를 LLM 이 컴파일해 영구 위키로 만드는 위성 볼트입니다. 매번 RAG 로 재검색하지 않고, 한 번 컴파일된 위키가 다음 ingest 의 컨텍스트가 되어 compounding artifact 로 누적됩니다. CMDS LLM Wiki is a satellite vault where external sources are compiled by LLM into a permanent wiki. Instead of re-fetching via RAG each query, once-compiled knowledge becomes context for the next ingest — accumulating as a compounding artifact.

• Vault 경로: /Users/yohankoo/Local Obsidian_MBP/CMDS_LLM_Wiki/Vault path: /Users/yohankoo/Local Obsidian_MBP/CMDS_LLM_Wiki/
• 주저자: 사용자 + LLM (Claude Code 가 primary author)Primary author: User + LLM (Claude Code as primary author)
• 마더십: CMDSPACE_Local_MBP (사람이 primary author)Mothership: CMDSPACE_Local_MBP (human as primary author)
• 관계: 같은 사용자, 다른 합의 모델 — kepano 의 contamination mitigation 원칙Relationship: Same user, different consensus model — per kepano's contamination mitigation principle

Karpathy LLM Wiki Pattern

2026-04-06 에 Andrej Karpathy 가 제안: "다음 시대의 지식 시스템은 RAG 가 아니다. LLM 이 직접 위키를 작성하고 유지한다. Raw source 는 코드, wiki 는 컴파일된 실행파일. 한 번 컴파일하면 재사용된다." Proposed by Andrej Karpathy on 2026-04-06: "The next knowledge system is not RAG. LLM authors and maintains the wiki directly. Raw sources are code, the wiki is the compiled runtime. Once compiled, it is reused."

3-Layer Architecture

Karpathy 패턴의 직접 구현. 세 계층은 명확히 분리되며 권한과 책임이 다릅니다. Direct implementation of the Karpathy pattern. The three layers are cleanly separated with distinct permissions and responsibilities.

┌──────────────────────────────────────────────────────────────────┐
│                                                                  │
│  Layer 1: Raw Sources       Layer 2: Wiki         Layer 3: Schema│
│  (소스코드, immutable)       (실행파일, LLM 작성)   (CLAUDE.md)   │
│                                                                  │
│  📄 11. Articles    ──┐                                          │
│  📑 12. Papers      ──┤                                          │
│  📚 13. Books       ──┼──▶ /ingest ──▶  21. Concepts (98)        │
│  🎙 14. Transcripts ──┤    (compiler)   22. Entities (54)        │
│  🌐 15. Clippings   ──┘                 23. Guides   (18)        │
│                                         24. Maps     (5)         │
│  101 sources                            ─────                    │
│  IMMUTABLE                              178 pages, growing       │
│                                                                  │
│  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━  │
│                                                                  │
│  Schema (CLAUDE.md) governs ALL of the above:                    │
│   · Folder conventions  (Layer 1 + 2)                            │
│   · Frontmatter rules    (every .md file)                        │
│   · Ingest/Query/Lint specs (operations)                         │
│   · Wiki page anatomy    (Layer 2 templates)                     │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

Layer 1: Raw Sources (불변)Layer 1: Raw Sources (immutable)

외부 자료의 1차 캡처. 한 번 ingest 되면 수정 금지. 출처 추적성을 위함. 10. Raw Sources/ 하위 5 카테고리: Articles · Papers · Books · Transcripts · Clippings. First capture of external sources. Once ingested, no edits. For source traceability. Under 10. Raw Sources/ with 5 subcategories: Articles · Papers · Books · Transcripts · Clippings.

Layer 2: Wiki (LLM 컴파일)Layer 2: Wiki (LLM-compiled)

LLM 이 raw source 에서 추출·재구성한 페이지. 4 종류: Pages extracted and re-structured by LLM from raw sources. 4 types:

Layer 3: Schema (메타 룰)Layer 3: Schema (meta-rules)

CLAUDE.md 가 schema layer. 모든 LLM 행동의 single source of truth. "Schema is the harness" — 컴파일러를 정의하는 메타 코드. CLAUDE.md is the schema layer. Single source of truth for all LLM behavior. "Schema is the harness" — meta-code defining the compiler.

폴더 구조Folder Structure

CMDS_LLM_Wiki/
├── 00. Inbox/             ← /ingest 대기 큐
├── 10. Raw Sources/       ← Layer 1 (불변, 101 files)
│   ├── 11. Articles/
│   ├── 12. Papers/
│   ├── 13. Books/
│   ├── 14. Transcripts/
│   └── 15. Clippings/
├── 20. Wiki/              ← Layer 2 (LLM 컴파일, 178 pages)
│   ├── 21. Concepts/
│   ├── 22. Entities/
│   ├── 23. Guides/
│   └── 24. Maps/
├── 30. Queries/           ← /query 답변 file-back (7)
├── 70. Outputs/           ← 외부용 산출물
├── 80. References/
│   └── Attachments/
├── 90. Settings/
│   ├── Sharing/
│   └── Templates/
│
├── CLAUDE.md              ← Schema Layer (precedence 1)
├── AGENTS.md              ← 타 에이전트용 (Codex, Cursor)
├── Core Context.md        ← 마더십 컨텍스트 snapshot
├── index.md               ← Master Index (auto-updated on ingest)
├── LLM-Wiki-Starter-Kit.md ← 외부 사용자 안내
└── log.md                 ← Ingest/Query 활동 로그

시스템 파일 (6 개)System Files (6)

위성 볼트의 system file 은 6 개. 마더십의 8 개 보다 적은 이유는 vendor-specific (ANTIGRAVITY) 와 Gobi 페르소나 (BRAIN/BRAIN_PROMPT) 가 위성에 없기 때문. The satellite vault has 6 system files. Fewer than the mothership's 8 because vendor-specific (ANTIGRAVITY) and Gobi persona (BRAIN/BRAIN_PROMPT) don't apply here.

Multi-Vault Architecture

사용자는 총 7 vault 를 운영합니다. 각 vault 는 다른 governance (누가 합의 권한 가짐) 와 purpose 를 가집니다. The user operates 7 vaults total. Each has different governance (who has authoring authority) and purpose.

자세한 내용은 satellite 의 20. Wiki/23. Guides/Multi-Vault Architecture.md 가이드 참조 (canonical). For details, see the satellite's 20. Wiki/23. Guides/Multi-Vault Architecture.md guide (canonical).

Cross-vault References

Obsidian wikilink 는 볼트 경계를 못 넘습니다. 따라서: Obsidian wikilinks can't cross vault boundaries. So:

• Frontmatter: source-vault: CMDSPACE_Local_MBP 로 출처 명시Frontmatter: source-vault: CMDSPACE_Local_MBP to indicate origin
• 본문: obsidian://open?vault=...&file=... URL 사용Body: Use obsidian://open?vault=...&file=... URLs
• 텍스트: → LLM Wiki: {page name} 형식 텍스트 참조도 OKText: → LLM Wiki: {page name} text references are also fine
• 검색: qmd MCP 는 user-scope 등록되어 어느 볼트에서든 양쪽 모두 검색 가능Search: qmd MCP is user-scoped, can search both vaults from either side

// Mothership 노트에서 satellite 참조
mainVaultRelated:
  - "[Multi-Vault Architecture](obsidian://open?vault=CMDS_LLM_Wiki&file=20.%20Wiki%2F23.%20Guides%2FMulti-Vault%20Architecture)"

// Satellite 노트에서 mothership 참조
source-vault: CMDSPACE_Local_MBP
source:
  - "[CLAUDE.md](obsidian://open?vault=CMDSPACE_Local_MBP&file=CLAUDE)"

Living Reference Policy

위성 볼트의 Core Context.md 는 마더십 5+1 system files 의 snapshot 입니다. 마더십이 진화하면 snapshot 도 drift 합니다. The satellite's Core Context.md is a snapshot of the mothership's 5+1 system files. As the mothership evolves, the snapshot drifts.

Refresh 절차: /refresh-context 스킬 사용. 절대 마더십 원본을 위성에 복사하지 않습니다 — Core Context 가 single point of truth. Refresh procedure: Use /refresh-context skill. Never copy mothership originals to satellite — Core Context is the single point of truth.

/ingest — 외부 자료 흡수External source absorption

Article · paper · book · transcript · clipping 을 받아 10. Raw Sources/ 에 저장 후 LLM 이 추출한 개념·엔티티를 20. Wiki/ 에 컴파일. Takes article · paper · book · transcript · clipping, stores in 10. Raw Sources/, then LLM extracts concepts/entities and compiles to 20. Wiki/.

필수 1회 질문: 수집 목적Required one-time question: collection purpose

"미래의 나에게 보내는 편지" 원칙: 매 ingest 첫 단계에 왜 이걸 수집하느냐 1회 질문. 답변은 collectionPurpose 프로퍼티에 기록되어 추후 query 시 컨텍스트로 활용. "Letter to my future self" principle: at the start of each ingest, ask why this is being collected once. The answer goes into collectionPurpose property, used as context in future queries.

/query — 합성 답변Synthesized answer

위키 + raw sources 검색 (qmd) → LLM 합성 → 답변. wiki-worthy (재사용 가치) 면 30. Queries/ 에 file-back. cross-vault 옵션으로 마더십도 함께 검색 가능. Searches wiki + raw sources (qmd) → LLM synthesizes → answer. Wiki-worthy (reusable) queries get filed back to 30. Queries/. Cross-vault option searches mothership too.

/lint — 위생 점검Health check

Read-only. 다음 항목 검사 후 리포트만 — 자동 수정 안 함: Read-only. Reports on the following — no auto-fix:

• Orphan 페이지 (참조 받는 곳 없음)Orphan pages (no inbound references)
• Contradiction (서로 모순되는 위키 페이지)Contradictions (mutually inconsistent wiki pages)
• Stale (마지막 갱신 후 N 일 경과)Stale (N days since last update)
• Frontmatter 일관성 (필수 7 properties)Frontmatter consistency (7 required properties)
• Living Reference Policy 위반 (Core Context 30일 경과)Living Reference Policy violation (Core Context 30+ days old)

5 종 검색 방법Search Methods

위성 볼트에서 사용 가능한 5 종 검색 — 각자 다른 신호를 봅니다: 5 search methods available — each looks at different signals:

자세한 비교는 satellite 가이드 Wiki Search Methods Comparison.md 참조. 5 종을 결합하는 recipe 도 명시되어 있습니다. For detailed comparison, see satellite guide Wiki Search Methods Comparison.md. Recipes combining all 5 are also documented.

프로퍼티 표준Frontmatter Standard

위성 볼트 모든 .md 는 마더십과 동일한 7 필수 프로퍼티 + Layer-specific 추가 필드: All .md files in the satellite use the same 7 required properties as mothership + Layer-specific additions:

---
type: wiki-page          # or raw-source, query, schema
aliases: []
description: "English 1-2 sentence summary for LLMs"
author:
  - "[[구요한]]"
  - Claude
date created: 2026-05-04T10:00
date modified: 2026-05-04
tags: [system]
# Wiki page 추가:
related:
  - "[[Other Wiki Page]]"
source:
  - "[[2026-04-29-some-raw-source]]"
mainVaultRelated:               # cross-vault to mothership
  - "→ Mothership: CLAUDE.md"
mainVaultCmds:
  - "[[📚 601 Knowledge Management]]"
confidence: high
layer: concepts                # concepts | entities | guides | maps
status: active
---

디자인 결정Design Decisions

위성 볼트 디자인의 핵심 결정 5 가지 (kepano contamination mitigation 영향): 5 key design decisions for the satellite vault (influenced by kepano's contamination mitigation):

1. 주저자 분리: 마더십 = 사람 primary author, 위성 = LLM primary author. 같은 볼트에 섞으면 신뢰의 출처 흐려짐.Author separation: Mothership = human primary, satellite = LLM primary. Mixing them blurs source of trust.
2. 합의 모델 분리: 마더십은 단독 결정, 위성은 LLM 자동 + 사람 검토. git/sync 충돌 방식이 다름.Consensus model separation: Mothership = solo, satellite = LLM auto + human review. Different git/sync conflict patterns.
3. 도구 분리: 위성에만 qmd 인덱싱, validate-raw-source hook, 자동 reindex. 마더십에 부담 안 줌.Tool separation: Only satellite has qmd indexing, validate-raw-source hook, auto reindex. Doesn't burden mothership.
4. 검색 인덱스 분리: qmd collection 단위 분리 (wiki / raw_sources / queries). 마더십도 별도 collection 으로 등록.Search index separation: qmd collections (wiki / raw_sources / queries). Mothership registered as separate collection.
5. Sync 분리: 마더십 = Obsidian Sync (2 Mac), 위성 = git only. LLM 작성이라 commit message 자연스러움.Sync separation: Mothership = Obsidian Sync (2 Macs), satellite = git only. Natural commit messages from LLM authorship.