KO EN
CS_V6_Obsidian — Field Note No. 03
2026 / SEOUL
지식 컴파일러 · 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_V6 Obsidian 설계 원칙
§ 01

Two layers, 두 레이어 구조의 모든 것

Layer 1 · 불변
raw/
Layer 2 · 재컴파일 가능
wiki/
사람이 던진다 → AI가 컴파일한다 → 지식 그물이 쌓인다
CS_V6/ ├─ raw/ # 불변 원본 — 경로·내용 수정 금지 │ └─ _attachments/ # 이미지·PDF │ ├─ wiki/ │ ├─ master-index.md # 전체 카탈로그 (query 시작점) │ ├─ log.md # append-only 활동 로그 │ ├─ open-questions.md # 답 못한 query 누적 │ ├─ concepts/ # 단일 진리원 개념 페이지 │ ├─ entities/ # 사람·도구·회사 │ ├─ topics/<t>/ # 주제 클러스터 │ ├─ summaries/ # raw 1:1 요약 │ ├─ queries/ # 승격된 Q&A │ ├─ digests/ # 주간 시놉시스 │ └─ _meta/ # glossary / stats / golden eval │ ├─ .claude/skills/llm-wiki/SKILL.md # 운영 매뉴얼 (한 파일에 모든 로직) ├─ CLAUDE.md # LLM 세션 진입점 └─ MANUAL.md # 사람 읽는 사용 가이드

raw 파일은 한 글자도 수정하지 않습니다. 경로도 바뀌지 않습니다. wiki는 언제든 재-컴파일 가능합니다. 잘못되면 지우고 다시 ingest하면 됩니다.

검색의 출발점은 wiki/master-index.md입니다. raw는 마지막 보루입니다. 시간이 쌓일수록 양방향 [[wikilink]] 그물이 자연스럽게 두터워지도록 설계되어 있습니다.

§ 02

The project CS_V6 Obsidian 오픈소스 템플릿

// CS_V6_Obsidian

Knowledge
Compiler Karpathy 패턴을 한국어 볼트로

clone 한 번, init.sh 한 번이면 완전히 빈 볼트에서 자기만의 지식 그물을 키워나갈 수 있는 구조. SKILL 파일 하나만 손보면 자기 취향대로 튜닝 가능.

ObsidianClaude CodeSKILL.md한국어 wiki
github.com/intenet1001-commits/CSV6_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_V6 Quick Start
# 1. repo clone git clone https://github.com/intenet1001-commits/CSV6_obsidian.git CS_V6 cd CS_V6   # 2. 부트스트랩 실행 (최초 1회 · 멱등성 보장) ./scripts/init.sh   # 3. Obsidian → Open another vault → CS_V6 선택 # 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_V6 폴더 열기
Drop
raw/에 파일 던지기 (뭐든 OK)
Ingest
/llm-wiki ingest로 wiki 컴파일
Query
/llm-wiki query “질문”으로 답 얻기
§ 05

Privacy first. repo에는 시스템만 올라간다

이 프로젝트에서 가장 인상 깊은 부분은 Git 정책입니다. repo에 올라가는 것은 시스템·템플릿뿐이고, 개인 볼트의 콘텐츠는 일절 포함되지 않습니다.

↑ git에 공개되는 것
  • README.md · CLAUDE.md · MANUAL.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_V6 Obsidian은 그 아이디어를 Obsidian + Claude Code + SKILL 조합으로 구현한 하나의 실제 작동 템플릿입니다.

Posted in ,

댓글 남기기

CS&NEWS에서 더 알아보기

지금 구독하여 계속 읽고 전체 아카이브에 액세스하세요.

계속 읽기