문서 · v2.8 · 템플릿 v1.11.0 · 2026-08-17Docs · v2.8 · Template v1.11.0 · 2026-08-17

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.

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."

핵심 통찰Key insight

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/20MOC — 카테고리 위계 시각화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 폴더 ≠ 7 레이어 — 핵심 3층 vs 운영·지원 폴더7 folders ≠ 7 layers — 3 core layers vs support folders

번호가 붙은 최상위 폴더는 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.mdSchema Layer — 모든 LLM 행동 규약Schema Layer — all LLM behavior rules사용자 + LLMUser + LLM
AGENTS.mdCodex · 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.mdMaster Index — 모든 wiki 페이지 카탈로그, ingest 마다 갱신Master Index — catalog of all wiki pages, updated on each ingestLLM
LLM-Wiki-Starter-Kit.md외부 사용자가 처음 볼트 받았을 때 안내First-time user onboarding사용자User
log.mdIngest/Query 활동 로그 — 무엇이 언제 어디서 추가됐나Ingest/Query activity log — what was added when from whereLLM

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
🌍 MothershipCMDSPACE_Local_MBPSolo모든 작업의 substrateSubstrate of all work
🛰 Compiled SatelliteCMDS_LLM_WikiSolo + LLM학습·연구 컴파일 (this vault)Compiled learning/research (this vault)
🤖 Personal ProductCMDS_GobiSolo + Gobi고비 제품 개인 사용Gobi product personal use
🤝 PairCMDS_JoonLab사용자 + 박준User + 박준교육·강의·컨설팅Education · lectures · consulting
🤝 PairCMDSPACE_Admin사용자 + 이태극User + 이태극운영 총괄Operations management
👥 Team (5인)GOBI5 인5 members고비 팀 협업Gobi team collaboration
📤 Distributioncmds-vault사용자 → 외부User → publicCMDS 스타터킷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:

// 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.

자동 검증 트리거Auto-check triggers

(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-tabsAI 챗·브라우저 탭 묶음 → 00. Inbox/05. AI Research/ (pre-ingest)AI-chat / browser tab bundle → 00. Inbox/05. AI Research/ (pre-ingest)
/inboxInbox 스캔 + 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)
/auditvault/MOC 전체 점검 → /verify 큐 생성Vault/MOC-wide audit → /verify queue
/linthealth check (orphan·모순·stale·frontmatter·Living Reference)Health check (orphans · contradictions · stale · frontmatter · Living Reference)
/status카운트 + coverage 스냅샷Counts + coverage snapshot
/reindexqmd 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)
Claude + Codex 듀얼 harnessClaude + Codex dual harness

같은 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:

/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).

3 검증 기준3 verification criteria

① 지식요건해당성 (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
BM25qmd lex키워드 빈도 + tf-idf · 결정적Keyword frequency + tf-idf · deterministic
Vectorqmd vec임베딩 코사인 유사도 · 의미·다국어Embedding cosine similarity · semantic + multilingual
HyDEqmd hyde가설 답변과 문서의 유사도 · 가장 정밀Hypothetical document similarity · most precise
Grepripgrep정규식 매칭 분포 · 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
claimTypedefinition · empirical · theoretical · historical · prescriptive · interpretive · mixed페이지의 지배적 claim 유형 (3종+ 섞이면 mixed)Dominant claim type (3+ mixed → mixed)
evidenceScopesingle-source · multi-source-primary · multi-source-mixed · synthesis-only · user-original출처의 폭·종류 (confidence calibration 입력)Breadth/type of sources (input to confidence calibration)
verificationStatusverified · partial · unverified · disputed3 기준 통과 상태 (신규 페이지 기본 unverified)3-criteria pass state (new pages default unverified)
verifiedAtYYYY-MM-DD최종 /verify 실행일Date of last /verify
verifiedByagent · human · both검증 주체Who verified
disputedtrue · falsetrue 면 충돌하는 다른 페이지와 양방향 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: trueverificationStatus: 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 Claim — 삭제 대신 보존Disputed Claim — preserve, don't delete

정합성 충돌이 발견되면 어느 쪽도 삭제하지 않고 양쪽 페이지에 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.

Parity Contract — CLAUDE.md ↔ AGENTS.mdParity Contract — CLAUDE.md ↔ AGENTS.md

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):

  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.

© 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