지식 컴파일러 · Knowledge Compiler
원본은 불변,
지식은 재컴파일
Andrej Karpathy가 제안한 Obsidian + LLM 활용법을 실제 작동하는 시스템으로 구현한 오픈소스 템플릿. raw는 한 글자도 건드리지 않고, AI가 옆에 한국어 wiki를 자동으로 그려준다면?
읽는 시간 5 MIN
주제 Obsidian · LLM · 지식관리
저자 CS
핵심 아이디어
CORE IDEA
기존 Obsidian 사용법은 노트를 그 자리에서 편집·정리하는 방식이었습니다. 하지만 LLM과 함께 쓰려면 원본(raw)과 해석(wiki)을 분리해야 한다는 것이 이 프로젝트의 출발점입니다.
raw는 단일 진리원(single source of truth), wiki는 언제든 다시 만들 수 있는 파생 산출물(derived artifact). SKILL·프롬프트·LLM이 개선되면 wiki를 버리고 다시 컴파일하면 그만입니다.
raw는 신성하다.
wiki는 언제든 다시 쓴다.
— CS_V7 Obsidian 설계 원칙
§ 01
Two layers,
두 레이어 구조의 모든 것
사람이 던진다 → AI가 컴파일한다 → 지식 그물이 쌓인다
CS_V7/
├─ raw/
│ └─ _attachments/
│
├─ wiki/
│ ├─ master-index.md
│ ├─ log.md
│ ├─ open-questions.md
│ ├─ concepts/
│ ├─ entities/
│ ├─ topics/<t>/
│ ├─ summaries/
│ ├─ queries/
│ ├─ digests/
│ ├─ _meta/
│ ├─ _broken/
│ └─ _scratch/
│
├─ scripts/init.sh
├─ .claude/skills/llm-wiki/SKILL.md
├─ CLAUDE.md
└─ AGENTS.md
raw 파일은 한 글자도 수정하지 않습니다. 경로도 바뀌지 않습니다. wiki는 언제든 재-컴파일 가능합니다. 잘못되면 지우고 다시 ingest하면 됩니다.
검색의 출발점은 wiki/master-index.md입니다. raw는 마지막 보루입니다. 시간이 쌓일수록 양방향 [[wikilink]] 그물이 자연스럽게 두터워지도록 설계되어 있습니다.
§ 02
The project
CS_V7 Obsidian 오픈소스 템플릿
// CS_V7_Obsidian
Knowledge
Compiler
Karpathy 패턴을 한국어 볼트로
clone 한 번, init.sh 한 번이면 완전히 빈 볼트에서 자기만의 지식 그물을 키워나갈 수 있는 구조. SKILL 파일 하나만 손보면 자기 취향대로 튜닝 가능.
ObsidianClaude CodeSKILL.md한국어 wiki
github.com/intenet1001-commits/CS7_obsidian →
핵심 설계 원칙 (30초)
- 01raw는 불변 — 외부 원본 그대로 보존, LLM이 수정하지 않음
- 02wiki는 재생성 가능 — 잘못되면 지우고 다시 ingest
- 03보안 — raw는 untrusted로 취급, 프롬프트 인젝션 차단
- 04프라이버시 — git에는 시스템만, 개인 콘텐츠 0% 노출
§ 03
By the numbers.
숫자로 본 이 시스템
설계의 단순함은 숫자에 드러납니다. 레이어 2개, 명령어 6개, 로직 파일 1개. 복잡할수록 망가지기 쉽고, 단순할수록 오래 씁니다.
아키텍처
레이어 수
2
raw (불변) + wiki (재컴파일)
모든 운영 로직
파일 수
1
SKILL.md 한 파일에 집중
튜닝도 수정도 한 곳에서
핵심 명령어
수
6
ingest · query · lint
digest · promote · status
git에 노출되는
개인 콘텐츠
0%
raw · wiki · glossary 모두 gitignore
페이지 제목조차 비공개
raw/wiki 분리의 4가지 이유 · Why separation matters
이유 01 · 불변성
LLM이 왜곡해도 원본이 있다
요약·재구조화 중 사실이 바뀌어도 raw가 옆에 있어 언제든 대조 가능
이유 02 · 재생성
SKILL·LLM 개선 시 다시 컴파일
wiki를 버리고 처음부터 다시 ingest — 실수가 영구적이지 않다
이유 03 · 보안
untrusted raw의 injection 차단
“ignore previous instructions” 류는 보고하고 무시. 웹 클리퍼 자료도 안전
이유 04 · 집단 기억
wikilink 그물이 자동으로 두터워짐
raw가 늘어날수록 wiki의 양방향 링크 그물이 자연스럽게 풍성해지는 구조
§ 04
5-minute setup.
5분 세팅부터 첫 ingest까지
Terminal — CS_V7 Quick Start
# 1. repo clone
git clone https://github.com/intenet1001-commits/CS7_obsidian.git CS_V7
cd CS_V7
# 2. 부트스트랩 실행 (최초 1회 · 멱등성 보장)
./scripts/init.sh
# 3. Obsidian → Open another vault → CS_V7 선택
# 4. 이 폴더에서 Claude Code 실행
claude
# 5. raw/에 파일 넣고 ingest → query
/llm-wiki ingest
/llm-wiki query “질문”
핵심 명령어 · Core Commands
/llm-wiki ingest [경로]
raw → wiki 컴파일. 인자 없으면 모든 미-ingest 파일 처리
/llm-wiki query “질문”
master-index부터 관련 wiki 페이지 추적, 답변 생성
/llm-wiki lint
orphan·dead-link·stale·PII·중복·broken frontmatter 검사
/llm-wiki digest
지난 7일 추가·갱신 페이지를 topic별로 시놉시스 생성
/llm-wiki promote
직전 query 답변을 wiki/queries/로 영구 승격
/llm-wiki status
전체 볼트 통계 (ingested / pending / stale 등)
Clone
repo clone 후 init.sh 실행
Open
Obsidian으로 CS_V7 폴더 열기
Drop
raw/에 파일 던지기 (뭐든 OK)
Ingest
/llm-wiki ingest로 wiki 컴파일
Query
/llm-wiki query “질문”으로 답 얻기
§ 05
Privacy first.
repo에는 시스템만 올라간다
이 프로젝트에서 가장 인상 깊은 부분은 Git 정책입니다. repo에 올라가는 것은 시스템·템플릿뿐이고, 개인 볼트의 콘텐츠는 일절 포함되지 않습니다.
↑ git에 공개되는 것
- README.md · CLAUDE.md · AGENTS.md
- .claude/skills/llm-wiki/SKILL.md — 운영 로직
- templates/ · scripts/init.sh — 빈 템플릿과 부트스트랩
- Obsidian 공통 설정 (.obsidian/)
✕ git에서 제외 (gitignore)
- raw/*.md — 모든 원본 자료 (제목 노출도 금지)
- wiki/concepts · entities · topics · summaries · queries · digests
- wiki/master-index.md — 전체 카탈로그
- wiki/log.md — 활동 이력
- wiki/_meta/glossary.md — 볼트 특화 용어집
개인 볼트의 어떤 콘텐츠도 git에 노출되지 않는다. 심지어 페이지 제목이나 용어집 같은 메타데이터도. git에는 오직 “이 시스템을 어떻게 다시 만들 것인가”만 담겨 있다.
설계 철학 · Design Philosophy
지식은 재생성 가능하다.
원본만이 불변이다.
Karpathy가 말한 본질은 “AI와 함께 성장하는 개인 지식 베이스”입니다. CS_V7 Obsidian은 그 아이디어를 Obsidian + Claude Code + SKILL 조합으로 구현한 하나의 실제 작동 템플릿입니다.
댓글 남기기