CMDS CMDS LLM Wiki v2.0
CMDS LLM Wiki · v2.2 · 템플릿 v1.4.0 (2026-05-27) CMDS LLM Wiki · v2.2 · Template v1.4.0 (2026-05-27)

사람과 AI 가 함께
컴파일하는 위키. A wiki that humans and AI
compile together.

외부 자료를 LLM 이 읽고 영구 위키로 컴파일하는 위성 볼트(satellite vault). 마더십 (CMDSPACE) 옆에 짝으로 배치되어, 매번 RAG 로 재검색하지 않고 한 번 컴파일된 지식이 계속 성장합니다. A satellite vault where LLM ingests external sources and compiles them into a persistent wiki. Sits paired with the mothership (CMDSPACE) — knowledge accumulates instead of being re-fetched each query.

아키텍처 문서 Architecture docs → 마더십 시스템 파일 Mothership system files GitHub
560
마크다운 파일Markdown files
264
위키 페이지Wiki pages
152
Raw SourcesRaw Sources
3-Layer
아키텍처Architecture
3-Layer 아키텍처3-Layer Architecture

소스코드 · 실행파일 · 스키마 Source · Runtime · Schema

Karpathy 가 2026-04-06 에 제안한 LLM Wiki 패턴의 직접 구현. Raw Sources 는 불변 소스코드, Wiki 는 LLM 이 컴파일한 실행파일, Schema 는 컴파일러를 정의하는 메타 룰입니다. Direct implementation of Karpathy's LLM Wiki pattern (2026-04-06). Raw Sources are immutable source code, Wiki is the LLM-compiled runtime, Schema is the meta-rule defining the compiler.

┌─────────────────────────────────────────────────────────────────────┐ │ │ │ ┌──────────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 10. Raw Sources │ │ Compiler │ │ 20. Wiki │ │ │ │ ──────────── │ │ ──────── │ │ ───── │ │ │ │ 📄 Articles │ ───▶ │ /ingest │ ───▶ │ Concepts │ │ │ │ 📑 Papers │ │ Claude Code │ │ Entities │ │ │ │ 📚 Books │ │ │ │ Guides │ │ │ │ 🎙 Transcripts │ │ (LLM reads, │ │ Maps │ │ │ │ 🌐 Clippings │ │ extracts, │ │ │ │ │ │ │ │ wikifies) │ │ 264 pages │ │ │ │ IMMUTABLE │ │ │ │ growing │ │ │ │ 152 sources │ │ │ │ │ │ │ └──────────────────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ │ │ │ │ governed by │ queried │ │ ▼ ▼ via │ │ ┌──────────────────────────────┐ │ │ │ CLAUDE.md (Schema Layer) │ │ │ │ ───────────────────────── │ │ │ │ · Folder conventions │ │ │ │ · Frontmatter standards │ │ │ │ · Ingest/Query/Lint specs │ │ │ │ · Wiki page anatomy │ │ │ │ │ │ │ │ "Schema is the harness" │ │ │ └──────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘

핵심 통찰: 매번 LLM 이 RAG 로 재검색하지 않습니다. 한 번 컴파일된 위키가 다음 ingest 의 컨텍스트가 되고, 지식이 compounding artifact 로 누적됩니다. Key insight: LLM doesn't re-fetch via RAG every time. Once compiled, the wiki becomes context for the next ingest — knowledge accumulates as a compounding artifact.

마더십 ↔ 위성 구조Mothership ↔ Satellite

두 볼트, 두 다른 합의 모델. Two vaults, two consensus models.

마더십과 위성은 같은 사용자의 두 볼트지만 주저자(primary author) 가 다릅니다. 마더십은 사람이 쓴 노트, 위성은 LLM 이 컴파일한 위키. kepano 의 contamination mitigation 원칙: 둘을 섞지 않습니다. Mothership and satellite are two vaults of the same user but have different primary authors. Mothership = human-authored notes, satellite = LLM-compiled wiki. Per kepano's contamination mitigation principle: don't mix them.

┌──────────────────────────────────────────────────┐ │ 🌍 CMDSPACE_Local_MBP (Mothership) │ │ Solo · 사람 primary author │ │ │ │ 9 system files (CLAUDE/AGENTS/ANTIGRAVITY/ │ │ CMDS/Guide/HQ/BRAIN/BRAIN_PROMPT/DESIGN) │ │ 9 categories (100-900) · 10K+ notes │ │ CMDS Process: Connect → Merge → Develop → Share│ └────────────────────┬─────────────────────────────┘ │ ┌───────────────┼───────────────┐ │ reference │ satellite │ │ (snapshot) │ branches │ ▼ ▼ ▼ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ Core │ │ 🛰 LLM Wiki │ │ Other │ │ Context.md │ │ (this vault) │ │ companion │ │ ────── │ │ ────── │ │ vaults │ │ Snapshot of │ │ Solo + LLM │ │ │ │ mothership │ │ Compiled │ │ JoonLab │ │ 9 system │ │ Karpathy │ │ Admin │ │ files │ │ pattern │ │ Gobi · GOBI │ │ │ │ │ │ cmds-vault │ │ Refresh │ │ 560 .md │ │ │ │ every 30d │ │ 264 wiki │ │ │ └──────────────┘ └──────────────┘ └──────────────┘

시스템 파일 매핑 System Files Mapping

계층Layer 마더십 (9 files)Mothership (9 files) 위성 (6 files)Satellite (6 files) 관계Relationship
기술 규칙Tech rules CLAUDE.md · AGENTS.md · ANTIGRAVITY.md CLAUDE.md (Schema) · AGENTS.md 위성 = 마더십 simplified + 3-Layer 추가Satellite = mothership simplified + 3-Layer
컨텍스트Context CMDS.md · 🏛 Guide · 🏛 HQ Core Context.md 위성 의 Core Context = 마더십 9 file 의 snapshot (30일 refresh)Satellite Core Context = snapshot of mothership 9 files (30-day refresh)
시각 언어Visual DESIGN.md (2026-05-22 신설, precedence 9) — v4.3 디자인 상수 · Anti-AI-Slop · 87-skill ↔ surface 매핑. 위성에서는 별도 시각 자산이 없어 미반영.v4.3 design constants · Anti-AI-Slop · 87-skill ↔ surface mapping. Satellite has no separate visual assets — not mirrored.
페르소나Persona BRAIN.md · BRAIN_PROMPT.md — Gobi 앱 entry — LLM coding agent 의 always-load 대상은 아님.Gobi app entry — not an always-load target for LLM coding agents.
진입점Entry point 🛰 CMDS_LLM_Wiki Satellite Vault.md index.md · LLM-Wiki-Starter-Kit.md 서로의 위치 가리킴 (cross-vault link)Each points to the other (cross-vault link)
로그Log — log.md 위성만 — ingest/query 활동 추적Satellite only — tracks ingest/query activity

Cross-vault wikilink 불가: Obsidian 위키링크는 볼트 경계를 넘지 못함. 서로 참조 시 obsidian://open?vault=...&file=... URL 사용. 단, qmd MCP 검색 은 user-scope 등록되어 어느 볼트에서든 양쪽 모두 검색 가능. No cross-vault wikilinks: Obsidian wikilinks can't cross vault boundaries. Reference each other via obsidian://open?vault=...&file=... URLs. However, qmd MCP search is user-scoped and can search both vaults from either side.

3 운영 작업3 Operations

Ingest · Query · Lint
위키의 호흡. Ingest · Query · Lint
The wiki's breath.

위키는 살아있는 시스템 — 들숨(Ingest)으로 raw source 를 흡수, 날숨(Query)으로 종합된 답변 생성, 위생점검(Lint)으로 일관성 유지. 마더십의 CMDS Process (Connect→Merge→Develop→Share) 와 다른 vocabulary 지만 보완적입니다. The wiki is a living system — Ingest absorbs raw sources, Query produces synthesized answers, Lint maintains consistency. Different vocabulary from the mothership's CMDS Process (Connect→Merge→Develop→Share) but complementary.

📥
/ingest
Slash command · raw → wiki
외부 자료 (article · paper · book · transcript) 를 수집해 10. Raw Sources/ 에 저장 후 LLM 이 추출한 개념·엔티티를 20. Wiki/ 에 컴파일. 수집 목적 (collectionPurpose) 1회 질문 후 진행. Collects external sources (article/paper/book/transcript) into 10. Raw Sources/, then LLM extracts concepts/entities and compiles to 20. Wiki/. Asks purpose once, then proceeds.
🔎
/query
Slash command · wiki → answer
qmd MCP (BM25 + Vector + HyDE) 로 위키와 raw sources 검색 후 답변 합성. wiki-worthy 면 30. Queries/ 에 file-back. 마더십 볼트도 함께 검색 가능 (cross-vault). Searches wiki + raw sources via qmd MCP (BM25 + Vector + HyDE), synthesizes answer. Wiki-worthy queries get filed back to 30. Queries/. Cross-vault search to mothership available.
🧹
/lint
Slash command · health check
Read-only 위생 점검 — orphan / contradiction / stale / frontmatter 일관성. Living Reference Policy 위반 (Core Context 30일 경과) 도 flag. 자동 수정 안 함, 사용자 결정 대기. Read-only health check — orphan / contradiction / stale / frontmatter coverage. Flags Living Reference Policy violations (Core Context 30+ days old). No auto-fix, waits for user decision.
v2.2 · 템플릿 v1.4.0 (2026-05-27)v2.2 · Template v1.4.0 (2026-05-27)

컴파일을 넘어 품질 게이트로. Beyond compilation — quality gates.

초기 위키는 "외부 자료 → 위키 컴파일" 의 단방향이었습니다. 6주간 운영하며 발견한 4개의 부족함을 메우는 schema 확장이 합류했습니다 — 읽지 않은 페이지 게이팅, 다중 챕터 책 분할 흡수, 도구 산출물 격리, 한·중·일 인명 표기. The early wiki was one-way: external source → wiki compilation. Six weeks of operation surfaced four gaps. The schema now closes them — unread-page gating, multi-chapter book progressive intake, tool-output isolation, CJK person naming.

🔓
Exploration Gate (v4)Exploration Gate (v4)
explored: false | true
새 위키 페이지는 모두 explored: false 로 시작. 사람이 직접 읽거나 에이전트가 source-backed 검증을 끝낸 뒤에만 explored: true. confidence: high 페이지는 반대해석 + 데이터 공백 1줄 기록 (Bias Check). /lint 가 unexplored backlog 보고. Every new wiki page starts with explored: false. Promoted to true only after human read or agent source-backed verification. confidence: high requires a counter-argument + data gap note (Bias Check). /lint reports unexplored backlog.
📚
Book Ingest (Progressive Stubs)Book Ingest (Progressive Stubs)
bookIndex · chapterNumber
5+ 챕터 책·문서 사이트 (mdBook · VitePress · GitBook · Docusaurus · ReadTheDocs) 는 한 번에 ingest 하지 않음. 1 Book Index + N chapter stubs (status: stub) + 소수 anchor wiki. 사용자가 챕터를 읽으면 해당 stub 을 promote (verbatim + wiki 컴파일 + status: completed). 5+ chapter books/doc sites (mdBook, VitePress, GitBook, Docusaurus, ReadTheDocs) aren't ingested in one shot. Create 1 Book Index + N stubs (status: stub) + few anchor wiki pages. When user reads a chapter, the matching stub is "promoted" — verbatim insertion + wiki compile + status: completed.
📦
70. Outputs/ 격리70. Outputs/ Isolation
{tool}/{YYYY-MM-DD}-{topic}/
외부 도구 (graphify · markdown-formatter) 산출물은 위키 본체 (10/20/30) 와 격리. 라이프사이클이 다름 — wiki 는 *컴파일 결과물*, outputs 는 *분석 결과*. 한 실행 = 한 dated 폴더, 인사이트는 30. Queries/ 로 정제 후 위키 흡수. External tool products (graphify, markdown-formatter) live outside the wiki body (10/20/30). Different lifecycle — wiki is *compiled knowledge*, outputs are *analysis artifacts*. One run = one dated folder; insights get refined into 30. Queries/ before joining the wiki.
🈂️
CJK 인명 표기CJK Person Naming
native script + aliases
한·중·일인 entity 파일명은 네이티브 스크립트만 (구요한.md, 张汉东.md). 영문 표기는 transliteration 이지 고유 이름이 아니므로 aliases 에 둠. Obsidian graph/검색은 aliases 도 인식 — 접근성 손실 없음. Korean/Chinese/Japanese person entity filenames use native script only (구요한.md, 张汉东.md). English transliteration goes in aliases — it's not a unique name. Obsidian graph/search resolves aliases — no accessibility loss.

Living Reference Policy Living Reference Policy

마더십의 9 시스템 파일은 위성과 독립적으로 진화합니다. 위성의 Core Context.md 는 그 진화의 snapshot 일 뿐 — 30일 이상 오래되면 /lint 가 flag 하고, /refresh-context 가 재snapshot 합니다. 절대 마더십 원본을 위성에 복사하지 않습니다. The mothership's 9 system files evolve independently of the satellite. The satellite's Core Context.md is just a snapshot of that evolution — older than 30 days and /lint flags it; /refresh-context re-snapshots. The original is never copied into the satellite.

최근 trigger: 2026-05-27 사용자 감사 (왜 Web Clipper JSON 이 빠져있지?) → 누락 3종 보충 → 템플릿 v1.4.0. 직전: 2026-05-22 마더십 8→9 file 전환 (DESIGN.md, precedence 9 신설) → 위성 Core Context v2.0 → v2.1. Latest trigger: 2026-05-27 user audit ("why are Web Clipper JSONs missing?") → 3 gaps filled → template v1.4.0. Previous: 2026-05-22 mothership 8→9 file restructure (DESIGN.md added, precedence 9) → satellite Core Context v2.0 → v2.1.

최신 릴리즈: v1.4.0 (2026-05-27) Latest release: v1.4.0 (2026-05-27)

사용자 감사에서 발견된 3종 누락 보충 — 운영 볼트와 공개 템플릿 간 drift 차단. User audit surfaced three template gaps that had silently drifted from the live operating vault.

v1.4.0 릴리즈 + ZIP 다운로드v1.4.0 Release + ZIP download →

폴더 구조Folder Structure

7 layers · 한 눈에 7 layers · at a glance

CMDS_LLM_Wiki/ ├── 00. Inbox/ ← 임시 처리 (queue for /ingest) ├── 10. Raw Sources/ ← 불변 (immutable, 131 files) │ ├── 11. Articles/ │ ├── 12. Papers/ │ ├── 13. Books/ │ ├── 14. Transcripts/ │ └── 15. Clippings/ ├── 20. Wiki/ ← LLM 컴파일 (compiled, 263 pages) │ ├── 21. Concepts/ (136 — 추상 개념) │ ├── 22. Entities/ (95 — 사람·도구·조직) │ ├── 23. Guides/ (23 — 운영 가이드) │ └── 24. Maps/ (9 — MOC) ├── 30. Queries/ ← 합성 답변 file-back (9 queries) ├── 70. Outputs/ ← 도구 산출물 (graphify · etc, dated 폴더) ├── 80. References/ ← 첨부파일 ├── 90. Settings/ ← 템플릿·공유 설정 │ ├── CLAUDE.md ← Schema Layer (LLM 행동 규약) ├── AGENTS.md ← 타 에이전트용 (Codex 등) ├── Core Context.md ← 마더십 사용자 컨텍스트 snapshot ├── index.md ← Master Index (auto-updated) ├── LLM-Wiki-Starter-Kit.md ← 외부 사용자 안내 └── log.md ← Ingest/Query 활동 로그

아키텍처 깊이 들어가기 Dig into the architecture

3-Layer 패턴, 시스템 파일 디테일, Living Reference Policy, 5종 검색 방법 — 모두 문서에서. 3-Layer pattern, system file details, Living Reference Policy, 5 search methods — all in the docs.

문서 읽기 Read docs →