CMDS LLM Wiki 아키텍처 CMDS LLM Wiki Architecture
Karpathy 의 LLM Wiki 패턴 (2026-04-06) 을 Obsidian + Claude Code · Codex 로 구현한 위성 볼트의 종합 문서. 마더십 (CMDSPACE_Local_MBP) 과 짝을 이루는 구조, 3-Layer 패턴, 6 system files, 10 operations (11 command 파일), Claude+Codex 듀얼 harness, v5 검증 스키마 (지식요건해당성·정합성·확증가능성), Living Reference Policy 까지. (공개 템플릿 v1.11.0) Comprehensive documentation of the satellite vault implementing Karpathy's LLM Wiki Pattern (2026-04-06) on Obsidian + Claude Code · Codex. Covers the paired structure with the mothership, the 3-Layer pattern, 6 system files, 10 operations (11 command files), the Claude+Codex dual harness, the v5 verification schema (eligibility · consistency · confirmability), and the Living Reference Policy. (public template v1.11.0)
개요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."
LLM 의 출력이 일회성 답변이 아니라 영구 자산 이 되어야 한다. RAG = 매번 재검색 (cost compounds). Compiled Wiki = 한 번 컴파일 후 누적 (value compounds). LLM output should be a permanent asset, not a one-time answer. RAG = re-fetch each time (cost compounds). Compiled Wiki = compile once, accumulate (value compounds).
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 ──┤ │ │ 🎙 14. Transcripts ──┼──▶ /ingest ──▶ 21. Concepts (230) │ │ 🌐 15. Clippings ──┤ (compiler) 22. Entities (187) │ │ 🤖 16. AI Research ──┘ 23. Guides (36) │ │ 24. Maps (20) │ │ 248 sources ───── │ │ IMMUTABLE 754 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 되면 수정 금지 — 원문을 verbatim 보존해 모든 위키 주장의 출처 추적성을 보장. 10. Raw Sources/ 하위 6 카테고리: 11 Articles · 12 Papers · 13 Books · 14 Transcripts · 15 Clippings · 16 AI Research (ChatGPT/Gemini/Grok/Claude/Perplexity 선행 조사). 원본이 바뀌면 삭제 대신 -v2 새 파일 + supersedes/superseded-by 양방향 링크로 보존.
First capture of external sources. Once ingested, no edits — originals kept verbatim so every wiki claim stays traceable. Under 10. Raw Sources/ with 6 subcategories: 11 Articles · 12 Papers · 13 Books · 14 Transcripts · 15 Clippings · 16 AI Research (ChatGPT/Gemini/Grok/Claude/Perplexity prior research). When a source changes, never delete — add a -v2 file with supersedes/superseded-by back-links.
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:
| 유형Type | 개수Count | 목적Purpose |
|---|---|---|
21. Concepts/ | 230 | 추상 개념 · 기술 · 방법론 (RAG, Compiled Wiki, Harness Design)Abstract concepts · techniques · methodologies (RAG, Compiled Wiki, Harness Design) |
22. Entities/ | 187 | 사람 · 도구 · 조직 (Karpathy, kepano, qmd, Anthropic)People · tools · orgs (Karpathy, kepano, qmd, Anthropic) |
23. Guides/ | 36 | 운영 가이드 (Multi-Vault Architecture, Wiki Search Methods)Operational guides (Multi-Vault Architecture, Wiki Search Methods) |
24. Maps/ | 20 | MOC — 카테고리 위계 시각화MOC — category hierarchy visualization |
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 (immutable, 248 files) │ ├── 11. Articles/ 12. Papers/ 13. Books/ │ ├── 14. Transcripts/ 15. Clippings/ │ └── 16. AI Research/ ← ChatGPT/Gemini/Grok/Claude 선행 조사 ├── 20. Wiki/ ← Layer 2 (LLM-compiled, 754 pages) │ ├── 21. Concepts/ 22. Entities/ │ └── 23. Guides/ 24. Maps/ ├── 30. Queries/ ← /query 답변 file-back (25) ├── 70. Outputs/ ← 외부 도구 산출물 (graphify 등) ├── 80. References/Attachments/ ├── 90. Settings/ (Sharing/ · Templates/) │ ├── .claude/ commands/ (11) · hooks/ (2) · settings.json ├── .codex/ commands/ (10) · hooks/ · hooks.json ← Codex 미러 ├── .agents/skills/ (10) ← Codex reusable skills ├── .obsidian/hotkeys.json ← 73 hotkey 바인딩 │ ├── CLAUDE.md ← Schema Layer (Claude, precedence 1) ├── AGENTS.md ← Schema Layer (Codex/Cursor 미러) ├── Core Context.md ← 마더십 9 system files snapshot ├── index.md ← Master Index (auto-updated on ingest) ├── LLM-Wiki-Starter-Kit.md ← 외부 사용자 안내 └── log.md ← Ingest/Query 활동 로그
번호가 붙은 최상위 폴더는 7개(00·10·20·30·70·80·90)지만 아키텍처의 정본은 3층입니다 — ① 10. Raw Sources = 소스코드(불변) → ② 20. Wiki = 실행파일(LLM 컴파일) → ③ Schema = CLAUDE.md/AGENTS.md = 컴파일러(3층은 폴더가 아니라 루트 문서). 나머지 00(전처리 Inbox) · 30(질의 산출물) · 70(도구 산출물 격리) · 80(첨부) · 90(템플릿·설정) 은 그 3층 위에서 돌아가는 운영·지원 폴더입니다. 특히 30. Queries/ 는 4번째 구조 레이어가 아니라 Ingest–Query–Lint 운영 축의 Query 단계 산출물입니다.
There are 7 numbered top-level folders (00·10·20·30·70·80·90), but the canonical architecture is 3 layers — ① 10. Raw Sources = source code (immutable) → ② 20. Wiki = runtime (LLM-compiled) → ③ Schema = CLAUDE.md/AGENTS.md = the compiler (layer 3 is a root document, not a folder). The rest — 00 (pre-ingest Inbox) · 30 (query output) · 70 (tool-output isolation) · 80 (attachments) · 90 (templates/settings) — are operational/support folders running on top of those three. In particular, 30. Queries/ is not a 4th structural layer — it's the Query-stage output of the Ingest–Query–Lint operational axis.
시스템 파일 (6 개)System Files (6)
위성 볼트의 핵심 system file 은 6 개. 마더십의 9 개 보다 적은 이유는 vendor-specific (ANTIGRAVITY), Gobi 페르소나 (BRAIN/BRAIN_PROMPT), 시각 언어 spec (DESIGN) 이 위성에 없기 때문. (단 Codex 듀얼-harness 의 AGENTS.md 는 위성에도 포함 — 아래 Operations 참조.)
The satellite vault has 6 core system files. Fewer than the mothership's 9 because vendor-specific (ANTIGRAVITY), Gobi persona (BRAIN/BRAIN_PROMPT), and the visual-language spec (DESIGN) don't apply here. (The Codex dual-harness AGENTS.md does ship in the satellite — see Operations.)
| File | 역할Role | 갱신 주체Maintained by |
|---|---|---|
CLAUDE.md | Schema Layer — 모든 LLM 행동 규약Schema Layer — all LLM behavior rules | 사용자 + LLMUser + LLM |
AGENTS.md | Codex · Cursor · Windsurf 등 타 에이전트용For Codex · Cursor · Windsurf etc. | 사용자User |
Core Context.md | 마더십 9 system files 의 snapshot — ingest/query 전에 LLM 이 반드시 먼저 읽음Snapshot of mothership 9 system files — LLM must read this BEFORE any ingest/query | 자동 (refresh-context 스킬)Auto (refresh-context skill) |
index.md | Master Index — 모든 wiki 페이지 카탈로그, ingest 마다 갱신Master Index — catalog of all wiki pages, updated on each ingest | LLM |
LLM-Wiki-Starter-Kit.md | 외부 사용자가 처음 볼트 받았을 때 안내First-time user onboarding | 사용자User |
log.md | Ingest/Query 활동 로그 — 무엇이 언제 어디서 추가됐나Ingest/Query activity log — what was added when from where | LLM |
Multi-Vault Architecture
사용자는 총 7 vault 를 운영합니다. 각 vault 는 다른 governance (누가 합의 권한 가짐) 와 purpose 를 가집니다. The user operates 7 vaults total. Each has different governance (who has authoring authority) and purpose.
| Type | Vault | 멤버Authors | Purpose |
|---|---|---|---|
| 🌍 Mothership | CMDSPACE_Local_MBP | Solo | 모든 작업의 substrateSubstrate of all work |
| 🛰 Compiled Satellite | CMDS_LLM_Wiki | Solo + LLM | 학습·연구 컴파일 (this vault)Compiled learning/research (this vault) |
| 🤖 Personal Product | CMDS_Gobi | Solo + Gobi | 고비 제품 개인 사용Gobi product personal use |
| 🤝 Pair | CMDS_JoonLab | 사용자 + 박준User + 박준 | 교육·강의·컨설팅Education · lectures · consulting |
| 🤝 Pair | CMDSPACE_Admin | 사용자 + 이태극User + 이태극 | 운영 총괄Operations management |
| 👥 Team (5인) | GOBI | 5 인5 members | 고비 팀 협업Gobi team collaboration |
| 📤 Distribution | cmds-vault | 사용자 → 외부User → public | CMDS 스타터킷CMDS starter kit |
자세한 내용은 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_MBPto indicate origin - 본문:
obsidian://open?vault=...&file=...URL 사용Body: Useobsidian://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 는 마더십 9 system files 의 snapshot 입니다. 마더십이 진화하면 snapshot 도 drift 합니다.
The satellite's Core Context.md is a snapshot of the mothership's 9 system files. As the mothership evolves, the snapshot drifts.
(1) 30 일 경과 (snapshot_date + 30일 < today) → /lint flag · (2) 마더십 system file 의 date modified 가 snapshot_date 보다 30일 이상 새로움 · (3) division rename, 새 focus axis, 새 command suite 같은 major 변경 후
(1) 30 days elapsed → /lint flags · (2) mothership system file's date modified is 30+ days newer than snapshot_date · (3) After major changes like division rename, new focus axis, or new command suite
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.
운영 작업은 10 operations(.claude/commands/ 에는 11 command 파일 — /onboard 는 템플릿 first-run 전용이라 상시 운영에는 안 셈)로 표준화돼 있습니다. 흐름: Capture Tabs → Inbox → Ingest → Query → Verify / Audit → Lint, 보조로 Status · Reindex · Refresh-Context.
Operations are standardized into 10 operations (.claude/commands/ holds 11 command files — /onboard is template first-run only, not counted in day-to-day runs). Flow: Capture Tabs → Inbox → Ingest → Query → Verify / Audit → Lint, plus Status · Reindex · Refresh-Context.
| Command | 역할Role |
|---|---|
/capture-tabs | AI 챗·브라우저 탭 묶음 → 00. Inbox/05. AI Research/ (pre-ingest)AI-chat / browser tab bundle → 00. Inbox/05. AI Research/ (pre-ingest) |
/inbox | Inbox 스캔 + ingest 라우팅 (read-only 라우터)Inbox scan + ingest routing (read-only router) |
/ingest | 목적 게이트 + Raw Source 저장 + Wiki 컴파일Purpose gate + Raw Source + Wiki compile |
/query | 컴파일된 Wiki 합성 답변 + (재사용 가치 시) Query Result file-backCompiled-Wiki synthesis + Query Result file-back when reusable |
/verify | 단일 페이지 검증 (정합성·출처·confidence)Single-page verification (consistency · sourcing · confidence) |
/audit | vault/MOC 전체 점검 → /verify 큐 생성Vault/MOC-wide audit → /verify queue |
/lint | health check (orphan·모순·stale·frontmatter·Living Reference)Health check (orphans · contradictions · stale · frontmatter · Living Reference) |
/status | 카운트 + coverage 스냅샷Counts + coverage snapshot |
/reindex | qmd update / embed / statusqmd update / embed / status |
/refresh-context | 마더십 9 system files 로 Core Context 재snapshotRe-snapshot Core Context from mothership 9 system files |
/onboard | 템플릿 first-run 인터뷰 셋업 (위성 운영본엔 없음)Template first-run interview setup (absent in operating satellite) |
같은 operation 이 3 면에 1:1 미러됩니다 — .claude/commands/ (Claude Code) · .codex/commands/ (Codex) · .agents/skills/ (Codex reusable skills) + AGENTS.md schema. Claude 작업은 CLAUDE.md + .claude/ 가, Codex 작업은 AGENTS.md + .codex/ 가 우선. Cursor · Windsurf 도 AGENTS.md 를 schema 로 참조.
Every operation mirrors 1:1 across three surfaces — .claude/commands/ (Claude Code) · .codex/commands/ (Codex) · .agents/skills/ (Codex reusable skills) + the AGENTS.md schema. Claude work prefers CLAUDE.md + .claude/; Codex work prefers AGENTS.md + .codex/. Cursor · Windsurf also read AGENTS.md as schema.
/ingest — 외부 자료 흡수External source absorption
Article · paper · book · transcript · clipping 을 받아 10. Raw Sources/ 에 저장 후 LLM 이 추출한 개념·엔티티를 20. Wiki/ 에 컴파일. 멀티 챕터 책·문서는 Book Ingest (progressive stub) 로 분할 흡수.
Takes article · paper · book · transcript · clipping, stores in 10. Raw Sources/, then LLM extracts concepts/entities and compiles to 20. Wiki/. Multi-chapter books/docs use Book Ingest (progressive stubs).
필수 1회 질문: 수집 목적Required one-time question: collection purpose
"미래의 나에게 보내는 편지" 원칙: 매 ingest 첫 단계에 왜 이걸 수집하느냐 1회 질문 (7 재활용 축: PhD · 학술 · 강의 · 컨설팅 · CMDS 시스템 · 에세이 · 제품). 답변 없이는 ingest 하지 않으며, 답변은 collectionPurpose 프로퍼티에 verbatim 기록되어 추후 query 시 컨텍스트로 활용됩니다. 이어서 Step 0-a 에서 마더십(CMDSPACE_Local_MBP)을 qmd + Grep 로 검색해 유사 노트 2~5개를 mainVaultRelated 에 기록. Raw Source 저장은 Copy 가 아니라 Move — ## Original Content 에 원문을 verbatim 보존하고, pre-flight 검증 통과 후에만 Inbox 원본을 rm 합니다(validate-raw-source.sh hook 강제).
"Letter to my future self" principle: at the start of each ingest, ask why this is being collected once (7 reuse axes: PhD · academic · lecture · consulting · CMDS system · essay · product). Ingest doesn't proceed without an answer; it's recorded verbatim into collectionPurpose and used as context in later queries. Then Step 0-a searches the mothership (CMDSPACE_Local_MBP) via qmd + Grep for 2–5 similar notes recorded in mainVaultRelated. Saving a Raw Source is a Move, not a Copy — originals are preserved verbatim under ## Original Content, and the Inbox original is rm'd only after pre-flight validation passes (enforced by the validate-raw-source.sh hook).
Book Ingest — Progressive StubsBook Ingest — Progressive Stubs
TOC 5+ 챕터의 책·문서 사이트(mdBook · VitePress · GitBook · Docusaurus · ReadTheDocs · Nextra)는 한 번에 긁어오지 않습니다. 1 Book Index + N chapter stub(status: stub) + 소수 anchor wiki 로 navigable scaffold 를 먼저 만들고, 사용자가 실제로 읽는 장만 "promote" 합니다 — 원문 verbatim 삽입 + Wiki 컴파일 + status: stub → completed. 30장 중 3장만 중요하면 3장만 승격하고 나머지는 영구 stub. "지식은 스크랩이 아니라 독서 시점에 컴파일"이라는 Karpathy 원칙의 구체화입니다.
Books / doc sites with a 5+ chapter TOC (mdBook · VitePress · GitBook · Docusaurus · ReadTheDocs · Nextra) are not scraped in one shot. First a navigable scaffold is built — 1 Book Index + N chapter stubs (status: stub) + a few anchor wiki pages — and only the chapters actually read get "promoted": verbatim insertion + wiki compile + status: stub → completed. If only 3 of 30 chapters matter, only 3 are promoted; the rest stay permanent stubs. This concretizes Karpathy's principle that knowledge is compiled at reading time, not scraped.
Exploration Gate — 새 페이지는 explored: false 로 시작Exploration Gate — new pages start as explored: false
모든 새 Wiki 페이지는 explored: false 로 생성됩니다. 사람이 직접 읽었거나 에이전트가 source-backed 검증 루프를 끝낸 뒤에만 explored: true 로 승격 — 에이전트는 이 필드를 임의로 뒤집지 않습니다. confidence(내용의 신뢰도)와 explored(사람이 봤는가)는 직교하는 두 축 이라 "high confidence + explored:false"(아직 인간이 안 읽은 고신뢰 페이지)가 정상적으로 존재합니다. confidence: high 로 올리는 페이지는 반드시 > [!note] Bias Check(반대해석 1줄 + 데이터 공백 1줄)를 함께 씁니다.
Every new wiki page is created with explored: false. It is promoted to explored: true only after a human read it or an agent finished a source-backed verification loop — agents never flip this field on their own. confidence (trust in the content) and explored (has a human seen it) are orthogonal axes, so "high confidence + explored:false" (a high-trust page no human has read yet) is a valid state. Any page raised to confidence: high must ship a > [!note] Bias Check (one counter-argument line + one data-gap line).
/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 + v2/v4/v5 커버리지 (collectionPurpose · explored · claimType/evidenceScope/verificationStatus)Frontmatter consistency — 7 required properties + v2/v4/v5 coverage (collectionPurpose · explored · claimType/evidenceScope/verificationStatus)
- Cross-vault 링크 무결성 (Step 10) —
mainVaultRelatedURL 을 마더십 파일시스템에 stat,mainVaultCmds카테고리를 최신 taxonomy 와 대조Cross-vault link integrity (Step 10) — statmainVaultRelatedURLs against the mothership filesystem, checkmainVaultCmdscategories against the current taxonomy - Living Reference Policy 위반 (Core Context 30일 경과)Living Reference Policy violation (Core Context 30+ days old)
/lint 는 기계적 건강(mechanical health) 을 10 step 으로 봅니다 — 링크·frontmatter·인덱스 정합. 반면 아래 /verify·/audit 는 인식적 건강(epistemic health) — claim 이 실제로 참인지, 출처와 정합적인지, confidence 가 과대/과소 선언되지 않았는지를 봅니다.
/lint checks mechanical health in 10 steps — links, frontmatter, index sync. The /verify and /audit operations below check epistemic health — whether a claim is actually true, consistent with its sources, and neither over- nor under-claimed in confidence.
/verify — 단일 페이지 검증 (v5)Single-page verification (v5)
한 Wiki 페이지를 3 품질 게이트로 검증하고 v5 검증 키를 페이지 frontmatter 에 되써넣습니다(write-back). 4 Phase 로 동작 — Phase 1 Eligibility(필수 7 + SPO 구조 + claimType/evidenceScope 분류), Phase 2 Consistency(vs source / vs 다른 Wiki / vs CLAUDE.md / vs Core Context 4 frame — 충돌은 삭제 대신 disputed: true 보존), Phase 3 Confirmability(선언된 confidence: 무시하고 독립 산출 → Overclaim/Underclaim flag), Phase 4 Write-back(verificationStatus·verifiedAt·verifiedBy 기록 + log.md).
Verifies one wiki page against 3 quality gates and writes v5 keys back to the page frontmatter. Runs in 4 phases — Phase 1 Eligibility (7 required + SPO structure + claimType/evidenceScope classification), Phase 2 Consistency (vs source / vs other wiki / vs CLAUDE.md / vs Core Context 4-frame — conflicts preserved as disputed: true, never deleted), Phase 3 Confirmability (ignore the declared confidence:, recompute independently → flag Overclaim/Underclaim), Phase 4 Write-back (records verificationStatus·verifiedAt·verifiedBy + log.md).
① 지식요건해당성 (Eligibility) — 주어·술어·객체·출처·증거범위·claim type 6 요소를 갖춘 형식적 지식 단위인가? · ② 정합성 (Consistency) — source·다른 페이지·정책·Core Context 와 충돌이 없는가? (충돌은 disputed 보존) · ③ 확증가능성 (Confirmability) — 독립 산출한 confidence 가 선언값과 일치하는가?
① Eligibility — is it a formal knowledge unit with subject · predicate · object · source · evidence-scope · claim-type? · ② Consistency — no conflict vs source, other pages, policy, or Core Context? (conflicts kept as disputed) · ③ Confirmability — does an independently recomputed confidence match the declared one?
/audit — 볼트 전체 점검 (v5)Vault-wide audit (v5)
볼트 전체를 같은 3 기준으로 훑어 drift 패턴을 표면화하고 /verify 우선순위 큐를 만드는 planner 입니다 (/audit = 기획자, /verify = 작업자). 모든 페이지를 개별 검증하지 않고(수백 LLM 호출 회피) MOC = semantic cluster 단위로 본다 — Phase A Eligibility Sweep(Grep 기반 deterministic), Phase B MOC-Cluster Consistency(클러스터 내 정의 차이·수치 불일치·처방 모순 탐지), Phase C Confirmability Sampling(모든 confidence: high + stale explored: false + random 10%), Phase D Synthesis(Vault Health + Top 10 action), Phase E Save(30. Queries/ 에 audit 리포트). 권장 주기: --full 월 1회, 주요 ingest 직후 --moc {영향 MOC}.
A planner that sweeps the whole vault against the same 3 criteria to surface drift patterns and build a prioritized /verify queue (/audit = planner, /verify = worker). Instead of verifying every page individually (avoiding hundreds of LLM calls), it works per MOC = semantic cluster — Phase A Eligibility Sweep (Grep-based deterministic), Phase B MOC-Cluster Consistency (definition drift · number mismatch · prescription conflict inside a cluster), Phase C Confirmability Sampling (all confidence: high + stale explored: false + random 10%), Phase D Synthesis (Vault Health + Top 10 actions), Phase E Save (audit report to 30. Queries/). Cadence: --full monthly, --moc {affected MOC} right after a major ingest.
5 종 검색 방법Search Methods
위성 볼트에서 사용 가능한 5 종 검색 — 각자 다른 신호를 봅니다: 5 search methods available — each looks at different signals:
| 방법Method | 도구Tool | 무엇을 보나What it sees |
|---|---|---|
| BM25 | qmd lex | 키워드 빈도 + tf-idf · 결정적Keyword frequency + tf-idf · deterministic |
| Vector | qmd vec | 임베딩 코사인 유사도 · 의미·다국어Embedding cosine similarity · semantic + multilingual |
| HyDE | qmd hyde | 가설 답변과 문서의 유사도 · 가장 정밀Hypothetical document similarity · most precise |
| Grep | ripgrep | 정규식 매칭 분포 · 100% recallRegex matching distribution · 100% recall |
| Graphify | /graphify | 노드·엣지·커뮤니티 그래프Nodes · edges · communities graph |
자세한 비교는 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 # high | medium | low (evidence strength) layer: concepts # concepts | entities | guides | maps explored: false # v4 — Exploration Gate (human-flip only) # v5 verification (written by /verify): claimType: theoretical # definition|empirical|theoretical|historical|prescriptive|interpretive|mixed evidenceScope: multi-source-primary # single-source | multi-source-primary | multi-source-mixed | synthesis-only | user-original verificationStatus: verified # verified | partial | unverified(default) | disputed verifiedAt: 2026-07-01 verifiedBy: agent # agent | human | both disputed: false ---
v5 검증 스키마v5 Verification Schema
2026-05-30 도입. v4 Exploration Gate 가 "누가 읽었나"만 추적하던 한계를 보완해, claim 단위의 정합성·확증가능성을 형식화했습니다. 모든 Wiki 페이지가 3 기준으로 평가될 수 있어야 하며, /verify(단일 페이지)와 /audit(볼트 전체)가 이 스키마를 읽고 씁니다.
Introduced 2026-05-30. It closes the gap where v4's Exploration Gate only tracked "who read it," formalizing claim-level consistency and confirmability. Every wiki page must be evaluable against 3 criteria, and /verify (single page) + /audit (whole vault) read and write this schema.
3 기준 — 지식요건해당성 · 정합성 · 확증가능성3 criteria — Eligibility · Consistency · Confirmability
| 기준Criterion | 묻는 것What it asks | 위반 시On failure |
|---|---|---|
| ① 지식요건해당성 Eligibility① Eligibility | 주어·술어·객체·출처·증거범위·claim type 6 요소를 갖춘 형식적 지식 단위인가? claimType+evidenceScope 분류 가능?Is it a formal unit with subject · predicate · object · source · evidence-scope · claim-type? Can claimType+evidenceScope be classified? | partial / ineligible |
| ② 정합성 Consistency② Consistency | vs source / vs 다른 Wiki / vs CLAUDE.md / vs Core Context 4 frame 에서 충돌 없는가?No conflict across the 4 frames: vs source / other wiki / CLAUDE.md / Core Context? | 양쪽 disputed: true (삭제 금지)Both sides disputed: true (never delete) |
| ③ 확증가능성 Confirmability③ Confirmability | 독립 산출한 confidence 가 선언된 confidence: 와 일치하는가?Does an independently recomputed confidence match the declared confidence:? | Overclaim / Underclaim flagOverclaim / Underclaim flag |
6 v5 키6 v5 keys
| Key | 값Values | 의미Meaning |
|---|---|---|
claimType | definition · empirical · theoretical · historical · prescriptive · interpretive · mixed | 페이지의 지배적 claim 유형 (3종+ 섞이면 mixed)Dominant claim type (3+ mixed → mixed) |
evidenceScope | single-source · multi-source-primary · multi-source-mixed · synthesis-only · user-original | 출처의 폭·종류 (confidence calibration 입력)Breadth/type of sources (input to confidence calibration) |
verificationStatus | verified · partial · unverified · disputed | 3 기준 통과 상태 (신규 페이지 기본 unverified)3-criteria pass state (new pages default unverified) |
verifiedAt | YYYY-MM-DD | 최종 /verify 실행일Date of last /verify |
verifiedBy | agent · human · both | 검증 주체Who verified |
disputed | true · false | true 면 충돌하는 다른 페이지와 양방향 Disputed Claim callout 으로 연결If true, linked to the conflicting page via a two-way Disputed Claim callout |
confidence vs verificationStatus vs explored — 직교하는 세 축confidence vs verificationStatus vs explored — 3 orthogonal axes
이름은 비슷하지만 추적 대상이 다릅니다 — confidence 는 증거 강도(high/medium/low), verificationStatus(v5)는 3 기준 통과 상태, explored(v4)는 누가 읽었나. 예: confidence: high + verificationStatus: verified + explored: false = "강한 증거 + 검증 완료, 그러나 아직 사람이 직접 안 읽음" 은 정상 조합입니다. explored: true 와 verificationStatus: verified 는 둘 다 사용자 명시 승인 없이 자동 전환 금지.
Similar names, different targets — confidence is evidence strength (high/medium/low), verificationStatus (v5) is the 3-criteria pass state, explored (v4) is who read it. E.g. confidence: high + verificationStatus: verified + explored: false = "strong evidence, verified, but not yet human-read" is a valid combination. Neither explored: true nor verificationStatus: verified may auto-flip without explicit user approval.
정합성 충돌이 발견되면 어느 쪽도 삭제하지 않고 양쪽 페이지에 disputed: true + > [!warning] Disputed Claim 콜아웃(서로를 cross-link)을 답니다. disputed 탈출 경로는 /verify --resolve 뿐 — 같은 턴에 새 증거가 제시될 때만, (양쪽 유지 / 한쪽 제거 / 진 쪽 confidence 강등) 중 하나로 해소. 삭제는 출처 없이 환각된 수치 같은 검증 가능한 사실 오류에만 쓰는 최후 수단입니다.
When a consistency conflict is found, neither side is deleted — both pages get disputed: true + a > [!warning] Disputed Claim callout cross-linking each other. The only exit is /verify --resolve, allowed only when new evidence is presented in the same turn, resolving to one of (keep both / drop one / downgrade the loser's confidence). Deletion is a last resort reserved for verifiable factual errors like a hallucinated, sourceless number.
Schema 층은 두 파일(CLAUDE.md Claude용 · AGENTS.md Codex/Cursor/Windsurf용)의 미러입니다. Parity Contract 는 반드시 동일해야 하는 섹션 — Cross-Agent Compatibility Matrix(10 operations) · 6 도메인 클러스터 · Frontmatter 표준(v2~v5) · Verification Properties(v5) · Callout Conventions — 을 못박아, 한쪽만 편집하는 drift 를 막습니다. 두 harness 는 같은 Schema 를 공유하되 Claude 작업은 CLAUDE.md+.claude/, Codex 작업은 AGENTS.md+.codex/ 가 우선입니다.
The schema layer is a mirror across two files (CLAUDE.md for Claude · AGENTS.md for Codex/Cursor/Windsurf). The Parity Contract pins the sections that must stay identical — the Cross-Agent Compatibility Matrix (10 operations) · 6 domain clusters · Frontmatter standards (v2–v5) · Verification Properties (v5) · Callout Conventions — to prevent one-sided edit drift. Both harnesses share one schema, but Claude work prefers CLAUDE.md+.claude/ and Codex work prefers AGENTS.md+.codex/.
디자인 결정Design Decisions
위성 볼트 디자인의 핵심 결정 5 가지 (kepano contamination mitigation 영향): 5 key design decisions for the satellite vault (influenced by kepano's contamination mitigation):
- 주저자 분리: 마더십 = 사람 primary author, 위성 = LLM primary author. 같은 볼트에 섞으면 신뢰의 출처 흐려짐.Author separation: Mothership = human primary, satellite = LLM primary. Mixing them blurs source of trust.
- 합의 모델 분리: 마더십은 단독 결정, 위성은 LLM 자동 + 사람 검토. git/sync 충돌 방식이 다름.Consensus model separation: Mothership = solo, satellite = LLM auto + human review. Different git/sync conflict patterns.
- 도구 분리: 위성에만 qmd 인덱싱, validate-raw-source hook, 자동 reindex. 마더십에 부담 안 줌.Tool separation: Only satellite has qmd indexing, validate-raw-source hook, auto reindex. Doesn't burden mothership.
- 검색 인덱스 분리: qmd collection 단위 분리 (wiki / raw_sources / queries). 마더십도 별도 collection 으로 등록.Search index separation: qmd collections (wiki / raw_sources / queries). Mothership registered as separate collection.
- 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.
© 2026 CMDSPACE · 작성: 구요한 + Claude · v2.8 · 템플릿 v1.11.0 (2026-08-17) · 마더십 시스템 파일은 system.cmdspace.work © 2026 CMDSPACE · Authored by Yohan Koo + Claude · v2.8 · Template v1.11.0 (2026-08-17) · Mothership system files at system.cmdspace.work