CMDS LLM Wiki
v2.9
CMDS LLM Wiki
v2.9
외부 자료를 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.
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.
LLM 이 읽고 · 추출하고 · 위키화LLM reads, extracts, wikifies
"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.
마더십과 위성은 같은 사용자의 두 볼트지만 주저자(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.
모선 9 시스템 파일의 스냅샷 · 30일마다 refreshSnapshot of mothership's 9 system files · refresh every 30d
Karpathy 패턴 컴파일 · 2330 .md · 1171 wikiCompiled Karpathy pattern · 2330 .md · 1171 wiki
JoonLab · Admin · Gobi · cmds-vault
| 계층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.
위키는 살아있는 시스템 — 들숨(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.
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.
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.
읽고 이해하는 것과 손으로 한 바퀴 돌려보는 것은 다릅니다. 아래 5단계는 순서대로 따라 하시면 됩니다 — 자료 한 편을 흡수(Ingest)해 위키 페이지로 컴파일하고, 그 위에서 질문(Query)해 근거가 달린 답을 받고, 위생 점검(Lint)까지 한 사이클입니다. Reading about it and running it once are different things. These five steps take you through one full cycle — ingest a source, compile it into wiki pages, query it, and lint the result.
cmds-llm-wiki-v1.13.0.zip 다운로드 → 압축 해제 → (Windows·링크가 풀린 경우) setup-agent-links 스크립트 실행 → Obsidian 에서 “Open folder as vault” 로 그 폴더를 엽니다. 기존 볼트에 섞지 마세요 — 위성은 별도 볼트여야 주저자 분리(contamination mitigation)가 성립합니다.
Download the release ZIP, unzip, run the setup-agent-links script if the links came out flattened (Windows), then Open folder as vault in Obsidian. Keep it as a separate vault — that separation is the whole point.
10. Raw Sources/ 원문(불변) · 20. Wiki/ LLM 이 컴파일한 페이지 · 90. Settings/ 스키마와 규칙. 지금은 거의 비어 있는 게 정상입니다 — 빈 그릇을 먼저 확인하고 채우기 시작합니다.
10. Raw Sources/ immutable originals · 20. Wiki/ compiled pages · 90. Settings/ schema and rules. Near-empty is expected at this point.
/ingest 에 자료 하나(논문 PDF·URL·유튜브 전사본)를 넘깁니다. 수집 목적을 딱 한 번 묻습니다 — 여기 성실히 답할수록 컴파일 품질이 올라갑니다. 결과: 원문이 10. 에 보존되고, 추출된 개념·엔티티가 20. 에 페이지로 생성됩니다.
Run your agent CLI inside the vault and pass one source to /ingest. It asks once why you are collecting it — answer well; compile quality depends on it.
/query 로 방금 흡수한 주제를 물어봅니다. 빈 채팅창의 답과 결정적으로 다른 점: 내가 넣은 코퍼스 안에서만 말하고, 근거 페이지로 링크가 걸립니다. 인용 조작이 구조적으로 줄어드는 지점이 여기입니다.
Ask about what you just ingested. The difference from a blank chat: it answers only from your corpus, with links back to the source pages.
/lint 로 고아 페이지·중복 개념·오래된 항목을 점검합니다. 좋은 /query 답변은 다시 위키 페이지로 편입시키세요 — 이게 복리(compounding)가 시작되는 지점이자, AKM Index 의 Loop 필러가 보는 바로 그 행동입니다.
Run /lint for orphans, duplicates and stale pages. File good answers back into the wiki — that write-back is where compounding starts.
cd 후 실행). ② 슬래시 커맨드가 안 뜸: 스타터킷의 .claude/ 폴더가 압축 해제 때 빠지지 않았는지 확인(숨김 폴더입니다). ③ 페이지가 안 만들어짐: 새 페이지는 explored: false 로 시작하는 게 정상입니다 — 스텁이 먼저 생기고 내용이 나중에 채워집니다.
Three common snags — 1. Run the CLI inside the vault folder. 2. Make sure the hidden .claude/ folder survived unzipping. 3. New pages start as explored: false stubs — that is expected.
| Command | 언제 쓰나When | 결과Result |
|---|---|---|
/ingest | 새 자료가 생겼을 때 (들숨)New source arrives | Raw Source 보존 + Wiki 페이지 컴파일Raw preserved + wiki compiled |
/query | 내 코퍼스에 물을 때 (날숨)Ask your corpus | 근거 링크가 달린 합성 답변Synthesized answer with citations |
/lint | 주기적 위생 점검Periodic hygiene | 고아·중복·stale 목록Orphans, duplicates, stale |
/verify | 한 페이지의 사실을 의심할 때Doubt one page | 단일 페이지 근거 검증Single-page verification |
/audit | 볼트 전체를 점검할 때Whole-vault check | 전체 일관성·신선도 리포트Consistency and freshness report |
각 커맨드의 옵션·게이트·프로퍼티 표준 등 전체 매뉴얼은 문서 페이지에 있습니다. 오늘은 한 바퀴 도는 것까지가 목표입니다 — 완벽한 구조보다 도는 루프가 먼저입니다. Full reference — options, quality gates, frontmatter standard — lives in the docs. Today, one full turn of the loop is enough.
초기 위키는 "외부 자료 → 위키 컴파일" 의 단방향이었습니다. 운영하며 메운 품질 게이트 4종에 더해, v1.5~v1.6 에서 Claude Code + Codex 듀얼 harness 와 대화형 /onboard 셋업이 합류했습니다. 같은 operation 을 두 에이전트에서 1:1 로 실행합니다.
The early wiki was one-way: external source → wiki compilation. On top of four quality gates added through operation, v1.5–v1.6 brought the Claude Code + Codex dual harness and an interactive /onboard setup. The same operations run 1:1 across both agents.
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.
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.
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.
홍길동.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.
.claude/commands/ (11) · .codex/commands/ (10) · .agents/skills/ (10) + AGENTS.md schema. Claude Code 와 Codex (Cursor·Windsurf 포함) 가 동일 harness 를 공유. 11 commands: ingest·query·lint·inbox·status·reindex·refresh-context·onboard·capture-tabs·verify·audit.
Since v1.6.0 every operation mirrors across 3 surfaces — .claude/commands/ (11) · .codex/commands/ (10) · .agents/skills/ (10) + the AGENTS.md schema. Claude Code and Codex (incl. Cursor/Windsurf) share one harness. 11 commands: ingest, query, lint, inbox, status, reindex, refresh-context, onboard, capture-tabs, verify, audit.
status: active 까지 자동. 수동 sed 셋업(Setup Guide.md)도 그대로 병행 지원.
One "onboard me" runs a 5-question interview (path, name, Mode A/B, mothership path, identity, reuse axes) → bulk placeholder substitution + Core Context authoring + status: active. The manual sed path (Setup Guide.md) still works in parallel.
마더십의 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-10-21 Explored 학습 보드 + MOC 지도 검토 (v1.13.0) — explored 메타데이터로 읽은 카드와 안 읽은 카드를 주제 영역·유형별로 모아 보는 Obsidian Bases 보드, MOC 의 explored 는 claim 카드와 분리한 지도 검토로. 직전: 2026-10-10 에이전트 설정 정본 폴더 + 숨김 폴더 링크 (v1.12.0) — 새 기기는 setup-agent-links 스크립트 한 번. 직전: 2026-08-27 Persona 레이어 (v1.11.1).
Latest trigger: 2026-10-21 Explored study board + MOC map review (v1.13.0) — an Obsidian Bases board that gathers read and unread cards by topic and type from explored metadata; a MOC's explored now means map review, separate from claim cards. Previous: 2026-10-10 canonical agent settings folder + dotfolder links (v1.12.0) — run the setup-agent-links script once on a new machine. Previous: 2026-08-27 Persona Layer (v1.11.1).
위키 카드가 쌓이면 어디까지 읽었는지 놓치기 쉽다. 카드마다 있는 explored(사람이 읽었나) 값을 모아 보는 Obsidian Bases 보드 20. Wiki/24. Maps/Explored 학습 보드.base 를 킷에 더했다. 표의 체크박스를 누르면 그 노트에 바로 읽음이 기록되고, 진행률은 영역마다 그룹 아래에 나온다. 원 저자의 운영 위키(카드 1,100여 개, MOC 32개)에서 먼저 검증한 구성이다.
As wiki cards pile up, it is easy to lose track of what you have actually read. This release adds an Obsidian Bases board, 20. Wiki/24. Maps/Explored 학습 보드.base, that gathers every card's explored (has a human read it?) value. Ticking the checkbox in the table writes the read mark straight into the note, and per-topic progress appears under each group. The layout was validated first in the author's working wiki (1,100+ cards, 32 MOCs).
domains 목록 순서로 대표 영역을 고른다.Topic = reverse MOC lookup — each card's topic comes from asking which MOCs link to it, checked from the MOC side. Cards in several MOCs take the first match in the board's domains list.confidence: high·충돌인데 아직 안 읽음), 최근 2주, 읽은 것, 영역별 진행률, 연구 질문, 논문 12단 분석, 이어 읽기(노트에 임베드), 지도 검토, 카드 훑어보기.11 views — queues by topic and by type, read-first (high-confidence or disputed but unread), last two weeks, read, progress by topic, research questions, 12-step paper analyses, continue-reading (embed in a note), map review, and a card browser.explored 는 "지도를 열어 구조를 훑었나" 를 뜻하는 선택 항목. 읽기 진행률은 claim 카드(wiki-page·research-question·persona)만 세고, /lint·/status 도 둘을 따로 보고한다.A MOC is a map, not a card — a MOC's explored is optional and means “I opened the map and skimmed its structure”. Reading progress counts claim cards only (wiki-page, research-question, persona), and /lint and /status report the two separately.번호가 붙은 최상위 폴더는 7개(00·10·20·30·70·80·90)지만, 아키텍처의 핵심은 3층입니다 — 10. Raw Sources(소스코드) → 20. Wiki(실행파일) → Schema(CLAUDE.md, 컴파일러). 나머지 00·30·70·80·90 은 그 3층 위에서 돌아가는 운영·지원 폴더입니다. 아래 트리로 전체를 보고, 표에서 각 레이어가 무엇인지 확인하세요. There are 7 numbered top-level folders (00·10·20·30·70·80·90), but the architecture is really 3 layers — 10. Raw Sources (source code) → 20. Wiki (runtime) → Schema (CLAUDE.md, the compiler). The rest (00·30·70·80·90) are operational / support folders running on top of those three. Scan the tree for the whole, then the table for what each layer is.
| 레이어Layer | 무엇인지What it is | 역할Role | 소유 · 특성Owner · trait |
|---|---|---|---|
00. Inbox |
대기소 (pre-ingest)Staging (pre-ingest) | Web Clipper·캡처가 착지하는 임시 큐. /ingest 가 읽어 10.Raw 로 이동Temporary queue where Web Clipper/captures land; /ingest moves them into 10. Raw |
처리 후 비움Emptied after processing |
10. Raw Sources |
① 소스코드 (불변)① Source code (immutable) | 원본을 verbatim 보관 — 모든 위키 주장의 근거. 11 Articles·12 Papers·13 Books·14 Transcripts·15 Clippings·16 AI ResearchOriginals kept verbatim — the evidence behind every wiki claim. 11 Articles · 12 Papers · 13 Books · 14 Transcripts · 15 Clippings · 16 AI Research | 인간 큐레이션 · 절대 수정·삭제 금지Human-curated · never edited/deleted |
20. Wiki |
② 실행파일 (LLM 관리)② Runtime (LLM-managed) | Raw 를 컴파일한 지식 페이지. 21 Concepts·22 Entities·23 Guides·24 Maps(MOC)Knowledge pages compiled from Raw. 21 Concepts · 22 Entities · 23 Guides · 24 Maps (MOC) | LLM 작성·cross-reference · 모든 주장에 출처LLM-written, cross-referenced · every claim sourced |
CLAUDE.md / AGENTS.md |
③ 스키마 (하네스)③ Schema (harness) | LLM 행동 규약 = "컴파일러 정의". 폴더 규칙·frontmatter·operation·검증 기준The LLM's rulebook = defines the compiler: folder conventions, frontmatter, operations, verification criteria | 인간+LLM 공동 진화Human + LLM co-evolve |
30. Queries |
질의 산출물 (운영 축)Query output (operational) | /query·/audit 가 위키를 종합한 답변을 file-back. "좋은 답변은 새 페이지로"/query//audit file synthesized answers back — "good answers become new pages" |
LLM 생성 · 4번째 구조층 아님LLM-made · not a 4th structural layer |
70. Outputs |
도구 산출물 격리Tool-output isolation | graphify 등 외부 도구 결과. wiki(컴파일 결과물)와 라이프사이클 분리External tool results (graphify, etc.) — isolated from the wiki, different lifecycle | dated 폴더 · 스키마 규칙 면제Dated folders · exempt from schema rules |
80. References |
첨부 저장소Attachment store | 모든 이미지·첨부를 한 곳(Attachments)으로 일원화All images/attachments unified in one place (Attachments) | 지원Support |
90. Settings |
설정·템플릿Settings · templates | Obsidian 노트 템플릿 · Web Clipper 공유 설정Obsidian note templates · Web Clipper sharing config | 지원Support |
3-Layer 패턴, 시스템 파일 디테일, Living Reference Policy, 5종 검색 방법 — 모두 문서에서. 3-Layer pattern, system file details, Living Reference Policy, 5 search methods — all in the docs.
문서 읽기 Read docs →커맨드스페이스(CMDSPACE) 대표 · 차의과학대학교 겸임교수 · 국가과학기술인력개발원(KIRD) 객원교수. AI 활용 · 지식관리 · 업무자동화 강의와 임원 코칭을 합니다. SK 경영포럼(이천포럼) 2년 연속 연사, LG그룹 900명 임원교육, LG전자·LG이노텍 CEO 1:1 코칭. 5,300+ 옵시디언 노트를 운영하는 지식관리 실천가. "바로 쓸 수 있는 것만, 깊이 있게." CEO of CMDSPACE · Adjunct Professor at CHA University · Visiting Professor at KIRD. Lectures and executive coaching on AI, knowledge management, and workflow automation. Two-time SK Management Forum speaker, LG's 900-executive program, and CEO 1:1 coaching at LG Electronics/Innotek. A knowledge-management practitioner running 5,300+ Obsidian notes. "Only what you can use tomorrow — in depth."