비개발자가 Claude Code 로 자기만의 옵시디언 PKM 위키 시스템을 만든 후기
2026.06.02
비개발자가 Claude Code 로 자기만의 옵시디언 PKM 위키 시스템을 만든 후기
📝 한줄 요약
오랜시간 쌓인 옵시디언 볼트를, Claude Code 와 함께 "원본은 그대로 두고 LLM 이 위키만 키우는" 구조로 재설계했다.
바쁘시면 이것만 읽어도 돼요:
사용한 도구와 목표: Claude Code + 옵시디언 공식 스킬 5종으로 PKM 표준 구축
핵심 구조: Raw(불변) / Wiki(LLM 갱신) / Schema(CLAUDE.md 규칙) 3계층
자동화 장치: PreToolUse hook 으로 원본 보호, PostToolUse hook 으로 변경 로그 자동 누적
결과: 278개 위키 페이지 카탈로그 + 활동 로그 자동 누적 + "질문 시 위키 먼저, 부족하면 원본" 동작
배운 교훈: "LLM 에게 위키를 키우게 하라" — 매 질문마다 원본을 뒤지는 RAG 보다 강력
🎯 이런 분들께 도움돼요
옵시디언에 자료는 쌓이는데 "다시 찾기"가 안 되는 분
AI 에이전트를 단발 질의가 아닌 "지식 누적 파트너"로 쓰고 싶은 분
비개발자지만 Claude Code · MCP · hook 을 업무에 녹이고 싶은 분
😫 문제 상황 (Before)
오랫 동안 책·웹 클리핑·사례·강의안이 노트로 쌓였다. 폴더 분류는 있었지만 다음 두 가지가 안 됐다.
다시 찾기 실패: 같은 개념을 3번째 검색할 때마다 원본 PDF·웹 클리핑을 처음부터 다시 뒤짐
AI 협업이 단발: Claude 에게 물어볼 때마다 매번 자료를 다시 던지고, 누적이 안 됨
근본 원인은 명확했다. "AI 에게 매번 원자료를 던지면 매번 처음부터다." 라이브러리에 사서가 없는 상태였다.
🛠️ 사용한 도구
Claude Code (CLI, opus-4-7)
옵시디언 공식 에이전트 스킬 5종:
obsidian-markdown·obsidian-bases·json-canvas·obsidian-cli·defuddle카파시(Andrej Karpathy)의 LLM Wiki 패턴 — Raw / Wiki / Schema 3계층 청사진
Claude Code Hooks — PreToolUse · PostToolUse
🔧 작업 과정
1) 청사진 매핑 — 기존 폴더에 역할만 부여
새 폴더는 만들지 않았다. 이미 있는 CMDS 폴더에 카파시 패턴의 역할을 매핑했다.
나에게 맞는 PKM 표준을 만들려면 어떻게 해야 하는지 단계별로 알려줘
Claude 가 5단계 플랜을 짜 줬는데 핵심은 한 줄이었다.
"원본은 안 건드린다. 위키는 LLM 이 키운다. 규칙은 CLAUDE.md 가 잡는다."
02. Clippings/ · 21. Source Books/ · 24. Web Articles/ → Raw 불변 영역30. Permanent Notes/ · 🏷 Index Notes/ · 📖 200 Literature/ → Wiki 갱신 영역CLAUDE.md · 🏛 CMDS Guide.md → Schema 규칙
2) Schema 박기 — CLAUDE.md 에 규약 5줄
가장 짧지만 가장 강력한 작업이었다. CLAUDE.md 에 다음 규약 한 섹션을 추가했다.
Raw 경로의 파일은 LLM 이 절대 수정·삭제하지 않는다.
한 페이지 = 한 개념 (Wiki).
Ingest: 새 자료가 들어오면 위키 페이지 1개 이상을 신설/갱신한다.
Query: 답하기 전 Wiki 를 먼저 읽는다. 부족할 때만 Raw 로 내려간다.
이 한 섹션이 박힌 뒤로 모든 작업이 자동으로 위키 패턴을 따랐다. "매번 지시"가 "한 번 규약"으로 바뀐 순간.
3) Ingest 반복 — URL 던지면 위키 페이지가 누적
가장 인상적이었던 워크플로우다. URL 하나 던지면 Claude 가:
https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f ingest 해줘
자동으로:
defuddle스킬로 웹페이지 정제Raw 폴더에 원본 보존
30. Permanent Notes/에 핵심 주장 1페이지를 위키 표준 frontmatter 로 신설wiki-index.md마스터 카탈로그에 1줄 자동 등록log.md에 활동 1줄 자동 append
다섯 단계가 한 번 요청으로 묶이는 게 정말 좋았다. "수집 = Raw 저장 + Wiki 갱신, 한 묶음" 이라는 원칙이 코드 레벨에서 강제됐다.
4) Hook 로 안전장치 — LLM 의지에 의존하지 않기
규약만으론 부족했다. CLAUDE.md 는 "참조"일 뿐 강제력이 없다. 그래서 코드 레벨 차단을 만들었다.
Raw 폴더 보호 hook 만들어줘. LLM 의지가 아니라 코드 레벨에서 차단되게.
.claude/hooks/raw-guard.sh (PreToolUse) — Raw 경로의 Edit/Write 덮어쓰기 차단.claude/hooks/wiki-reminder.sh (PostToolUse) — Wiki 변경 후 log.md 누락 시 알림
여기서 깨달았다. AI 협업에서 "규약"과 "차단"은 다른 층이다. 규약은 권고, 차단은 강제. 둘 다 필요하다.
5) Query 패턴 — 위키 먼저, 원본은 보조
이게 RAG 와의 결정적 차이였다. 같은 개념을 두 번째 물었을 때:
Before: 매번 원본 PDF·클리핑을 처음부터 다시 뒤짐
After: 위키 페이지 1개를 읽고 답함. 위키가 부족할 때만 Raw 로 내려감
지식이 누적되는 영구 자산이 됐다. 라이브러리에 사서가 생긴 상태.
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
같은 개념 재검색 | 원본 처음부터 다시 뒤짐 | 위키 1페이지 읽고 답 |
AI 협업 누적 | 매번 자료 다시 던짐 | 위키가 자동 누적 |
활동 추적 | 없음 |
|
마스터 카탈로그 | 없음 |
|
원본 안전 | LLM 의지에 의존 | hook 으로 코드 레벨 차단 |
결과물
3계층 폴더 매핑 — 새 폴더 0개, 기존 폴더에 역할만 부여
CLAUDE.md Wiki Pattern Rules 섹션 — 한 번 박으면 영구 적용
3개 hook — Raw 보호 · Wiki 변경 추적 · log append
278개 위키 페이지 —
wiki-index.md에 1줄 요약으로 카탈로그화
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
"매번 지시"를 "한 번 규약"으로 — CLAUDE.md 에 박은 5줄이 매 세션 자동 로드. 매번 같은 지시 반복 X.
새 폴더 만들지 않기 — 기존 분류에 "역할"만 부여. 마이그레이션 비용 0.
규약 + 차단 둘 다 — CLAUDE.md(권고) + hook(강제). LLM 의지에 의존하지 않음.
Index + Log 한 쌍 — 카파시 패턴의 핵심. 카탈로그(공간)와 활동 로그(시간) 둘 다 필요.
이렇게 하면 안 돼요
전체 1,500개를 한 번에 정리하려 함 — Wiki 영역(약 200~400개) 만 정상화. Raw 는 안 건드림.
자동화부터 만들기 — 처음엔 수동으로 3~4번 반복하며 패턴 굳히고, 그 뒤에 hook · schedule 로 자동화.
새 스킬부터 만들기 — 옵시디언 공식 스킬 5종이 이미 80% 커버. 새로 짓지 말고 매핑.
🌍 다른 업무에 적용한다면?
이 구조는 옵시디언이 아니어도 됩니다. 핵심은 "Raw 불변 / Wiki 갱신 / Schema 규칙" 3계층입니다.
고객 자료 관리: 원본 계약서·이메일은 Raw, 케이스 요약은 Wiki, 가명 규약은 Schema
세일즈 자료: 책·아티클은 Raw, 개념 페이지는 Wiki, 화법 규약은 Schema
강의 준비: 레퍼런스는 Raw, 강의 핵심 슬라이드는 Wiki, 청중별 톤 규약은 Schema
🚀 앞으로의 계획
2편: 실제 업무 영역에 위키 패턴 적용 사례
3편: Planner-Generator-Evaluator 3-에이전트로 장문 시리즈 자율 집필 실험
확장: 메일·문서 자동 정제 → 위키화 파이프라인
📋 재사용 가능한 프롬프트
프롬프트 1: PKM 표준 플랜 요청
나에게 맞는 PKM 표준을 만들려면 어떻게 해야 하는지 단계별로 알려줘. 내 볼트는 [폴더 구조 설명]. AI 에이전트로 Claude Code 를 쓰고 [목적]을 달성하고 싶어.
프롬프트 2: Schema 박기
CLAUDE.md 에 다음 규약을 추가해 줘:
Raw 경로 [경로 나열] 의 파일은 수정·삭제 금지
Wiki 경로 [경로 나열] 만 LLM 이 갱신
새 자료 ingest 시 Raw 저장 + Wiki 페이지 1개 이상 신설/갱신 묶음으로
프롬프트 3: Ingest 워크플로우
[URL 또는 텍스트] ingest 해줘.
→ 자동으로 Raw 저장 + Wiki 페이지 신설 + index 갱신 + log append 까지 한 번에.
프롬프트 4: Hook 강제
Raw 폴더 보호 hook 만들어 줘. CLAUDE.md 규약이 아니라 코드 레벨에서 차단되도록. PreToolUse 로 Edit/Write 를 막고, 사용자 메시지로 우회 경로(Wiki 페이지 신설)를 안내해 줘.
추천 이미지
"문제 상황" 섹션: 노트가 쌓인 옵시디언 그래프 뷰 스크린샷
"작업 과정 4단계" 섹션: hook 차단 메시지가 뜨는 터미널 화면
"결과" 섹션: 위키 인덱스 카탈로그 전체 화면
관련 노트
🏷 PKM 위키 패턴 — 카파시 + 옵시디언 스킬 — 메타 가이드
Karpathy LLM Wiki — 원문 분석 — 사상적 근거
wiki-index · log — 객관 수치 출처
Karpathy LLM Wiki — 원문 분석 — 사상적 근거




지난 글에서 봇을 두 캐릭터로 나누며 역할과 검수 기준을 잡으셨다면, 이번 글은 그 다음 단계로 “봇이 계속 참고할 지식층”을 만든 기록처럼 읽혔어요. Raw는 그대로 두고, Wiki는 LLM이 키우고, Schema는 CLAUDE.md가 잡는다는 3계층 정리가 특히 좋았습니다.
PreToolUse로 원본을 보호하고 PostToolUse로 변경 로그를 남긴 부분도 실무적으로 강해 보여요. 278개 위키 페이지 카탈로그보다 더 중요한 건, “질문 시 위키 먼저, 부족하면 원본”이라는 행동 규칙이 생긴 점 같아요. 이건 자료를 많이 넣은 사례라기보다, 에이전트가 매번 처음부터 헤매지 않게 길을 만들어준 사례에 가까워 보여요.
감사합니다. ❤️💕