Obsidian × Claude
제 2의 뇌 구축 가이드

1 시스템 개요

이 시스템은 Obsidian Vault를 지식 저장소로, Claude Code를 AI 두뇌로 연결해 1인 CEO가 사업 실행과 지식 관리를 동시에 처리할 수 있도록 설계된 통합 환경입니다. Andrej Karpathy의 LLM Wiki 패러다임에서 착안했으며, 모바일(Telegram 봇)과 PC(Claude Code)를 완전히 연결합니다.

✦ 왜 이 시스템인가

이 시스템을 구축하기 전에 먼저 이해해야 할 것이 있습니다. 이것은 단순한 노트 앱이 아닙니다. 사업 또는 여러 프로젝트를 함께 운영할 때 생기는 자료 분산과 맥락 반복을 줄이기 위한 예시 시스템입니다.

기존 도구와의 비교

맥락적 장점 7가지

3-Layer 구조

이 시스템의 핵심 규칙입니다. 모든 정보는 아래 세 레이어 중 하나에 정확히 속해야 합니다.

폴더 구조 (전체)

C:\Vault\YourName\
│
├── CLAUDE.md                    ← 시스템 헌법 (Claude가 세션마다 읽음)
├── Home.md                      ← 대시보드
│
├── brain/                       ← 목표·기억·결정·패턴
│   ├── North Star.md            ← 최상위 목표 (세션 시작 시 자동 로딩)
│   ├── Key Decisions.md         ← 주요 결정 기록
│   ├── Patterns.md              ← 반복 패턴 관찰
│   ├── Gotchas.md               ← 알려진 함정·버그
│   └── System-Guide.md          ← 이 시스템 사용 설명서
│
├── org/
│   └── people/                  ← 협업자 프로필 (/people-profiler로 관리)
│
├── work/
│   ├── active/                  ← 진행 중 프로젝트 (세션 시작 시 자동 스캔)
│   │   ├── new-product.md
│   │   ├── example-website.md
│   │   └── example-service.md
│   ├── archive/2026/            ← 완료 프로젝트 (/project-archive로 이동)
│   ├── 1-1/                     ← 1:1 미팅 노트
│   └── Index.md                 ← 전체 프로젝트 인덱스
│
├── perf/
│   ├── Brag Doc.md              ← 성과 기록 (/brag-spotter가 자동 추가)
│   ├── brag/                    ← 주간 brag 파일
│   └── competencies/            ← 역량 노트
│
├── raw/                         ← 원본 자료 (IMMUTABLE — 수정 절대 금지)
│   ├── articles/                ← defuddle로 저장한 웹 아티클
│   ├── research/                ← 리서치 자료
│   ├── competitors/             ← 경쟁사 분석 원본
│   ├── data/                    ← 데이터 파일
│   └── images/                  ← Telegram 이미지 (주제별 폴더)
│       ├── unsorted/            ← 캡션 없이 온 이미지
│       └── {주제}/{하위주제}/   ← #주제/하위 캡션으로 자동 분류
│
├── wiki/                        ← Claude가 생성·관리하는 인사이트 노트
│   ├── index.md                 ← 전체 위키 인덱스 (/compile이 자동 갱신)
│   ├── concepts/                ← 개념 노트
│   ├── entities/                ← 엔티티 노트
│   └── decisions/               ← 결정 노트
│
├── output/                      ← 산출물
│   ├── answers/                 ← Q&A 답변 (Filing-Back으로 wiki 승격)
│   ├── reports/
│   ├── slides/
│   └── charts/
│
├── thinking/
│   └── session-logs/            ← /dump 캡처, 세션 로그 자동 저장
│
├── templates/                   ← 노트 템플릿
│
├── graphify-out/                ← Graphify 지식 그래프 출력
│   ├── GRAPH_REPORT.md          ← 그래프 요약 (세션 시작 시 자동 참조)
│   └── wiki/index.md
│
└── .claude/                     ← Claude Code 설정 (숨김 폴더)
    ├── commands/                ← 슬래시 커맨드 19개
    ├── skills/                  ← 스킬 6개
    ├── scripts/                 ← 훅 스크립트
    └── rules/                   ← 상세 규칙 문서

일상 워크플로우 한눈에 보기

2 사전 준비

필수 도구 설치 목록

Vault 초기화

1. 1
   Vault 루트 폴더 생성
   mkdir C:\Vault\YourName — 경로는 자유롭게 설정하되, 이후 모든 스크립트에서 일관되게 사용
2. 2
   필수 폴더 구조 생성

   PowerShellps1

   $vault = "C:\Vault\YourName"
   $folders = @(
     "brain", "org\people", "work\active", "work\archive\2026",
     "work\1-1", "perf\brag", "perf\competencies",
     "raw\articles", "raw\research", "raw\images\unsorted",
     "wiki\concepts", "wiki\entities", "wiki\decisions",
     "output\answers", "output\reports", "output\slides",
     "thinking\session-logs", "templates",
     ".claude\commands", ".claude\skills",
     ".claude\scripts", ".claude\rules"
   )
   $folders | ForEach-Object { New-Item -ItemType Directory -Path "$vault\$_" -Force }

3. 3
   Obsidian에서 Vault 열기
   Obsidian → Open folder as vault → C:\Vault\YourName 선택
4. 4
   Claude Code에서 프로젝트로 열기
   cd C:\Vault\YourName && claude 실행 — CLAUDE.md가 자동으로 컨텍스트에 로딩됨

Git 설정 및 GitHub 연동 (선택)

아래 명령은 GitHub에 비공개 저장소를 먼저 생성한 뒤 실행하는 참고 예시입니다. 원격으로 올리기 전에 API 키, 개인자료, 고객정보, 계약서가 포함되었는지 확인하세요. Git은 버전 관리 도구이지 민감자료 자동 보호 장치가 아닙니다.

# 1. Git 초기화
cd C:\Vault\YourName
git init
git branch -M main

# 2. .gitignore 생성
echo ".obsidian/workspace*" >> .gitignore
echo ".smart-env/" >> .gitignore
echo ".smtcmp_json_db/" >> .gitignore
echo ".claude/scripts/telegram-bot.py" >> .gitignore  # 토큰 보안
echo "*.env" >> .gitignore

# 3. GitHub 원격 저장소 연결 (private repo 권장)
git remote add origin https://github.com/YourID/obsidian-vault.git

# 4. 초기 커밋
git add -A
git commit -m "init: vault structure"
git push -u origin main

3 CLAUDE.md 작성

CLAUDE.md는 Claude Code가 세션을 시작할 때 자동으로 읽는 시스템 헌법입니다. 이 파일이 없으면 Claude가 Vault의 규칙을 모릅니다. 루트에 반드시 작성하세요.

# CLAUDE.md - Vault 운영 매뉴얼

> Obsidian = IDE. LLM = programmer. Wiki = codebase.

## 정체성
[당신의 역할과 사업 목적을 1-3줄로 작성]
Obsidian + Claude Code + Karpathy LLM Wiki 루프.

## 3-Layer 불변 규칙
- **raw/** = 원본. IMMUTABLE. LLM은 읽기만.
- **wiki/** = LLM 전용. 생성·유지·교차참조 모두 LLM이 소유.
- **CLAUDE.md** = 스키마. 사용자+LLM이 함께 진화.
- raw/ → wiki/ 단방향만 허용. 역방향 절대 금지.

## 핵심 규칙 (NEVER 위반)
- 모든 .md에 YAML frontmatter 필수 (date, description, tags)
- 모든 노트에 [[wikilink]] 1개 이상. 링크 없는 노트 = 버그.
- wiki/ 노트에 source 필드로 raw/ 경로 필수.
- 불확실한 정보에 [unverified] 태그.
- .obsidian/ 설정 수정 금지.
- 삭제 전 반드시 사용자 확인.

## Context Navigation
1. ALWAYS query the knowledge graph first (graphify-out/GRAPH_REPORT.md)
2. Only read raw files if I explicitly say so
3. Use graphify-out/wiki/index.md as the file map
4. When searching, use QMD (qmd.cmd search "keyword") before reading files directly

## 명령어
/standup, /dump, /wrap-up, /weekly, /compile, /lint-wiki,
/vault-audit, /verify, /humanize, /project-archive

## 비즈니스 컨텍스트
[당신의 사업/프로젝트 목록을 작성]

4 Hooks 설정

훅은 Claude Code의 특정 이벤트(세션 시작, 메시지 전송, 파일 쓰기 등)에 Python/JS 스크립트를 자동 실행합니다. 설정 파일은 두 곳에 있습니다.

settings.json 훅 구성 예시 (고급·바로 붙여넣기 금지)

{
  "hooks": {
    // 1. 세션 시작 — North Star, git log, Graphify, QMD 로딩
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "C:/Python313/python.exe C:/Vault/YourName/.claude/scripts/session-start.py"
      }]
    }],

    // 2. 메시지 자동 분류 — 결정/성과/미팅/아이디어/문제/사람
    "UserPromptSubmit": [{
      "hooks": [{
        "type": "command",
        "command": "C:/Python313/python.exe C:/Vault/YourName/.claude/scripts/classify-message.py"
      }]
    }],

    // 3. 민감 파일 쓰기 차단 (.env, .key 등)
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "node C:/Vault/YourName/.claude/scripts/block-sensitive-files.js"
        }]
      },
      // 4. Graphify 사용 시 그래프 존재 여부 안내
      {
        "matcher": "Glob|Grep",
        "hooks": [{
          "type": "command",
          "command": "python -c \"import os,json;r={};p='graphify-out/graph.json';r['hookSpecificOutput']={'hookEventName':'PreToolUse','additionalContext':'graphify: Knowledge graph exists. Read graphify-out/GRAPH_REPORT.md before searching raw files.'} if os.path.exists(p) else None;r={k:v for k,v in r.items() if v is not None};print(json.dumps(r) if r else '{}')\""
        }]
      }
    ],

    // 5. .md 파일 쓴 후 frontmatter + wikilink 자동 검증
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{
        "type": "command",
        "command": "C:/Python313/python.exe C:/Vault/YourName/.claude/scripts/validate-write.py"
      }]
    }],

    // 6. 토큰 압축 전 세션 로그 백업
    "PreCompact": [{
      "hooks": [{
        "type": "command",
        "command": "C:/Python313/python.exe C:/Vault/YourName/.claude/scripts/pre-compact.py"
      }]
    }],

    // 7. 세션 종료 시 자동 커밋 + vault 상태 리포트
    "Stop": [
      {
        "hooks": [{
          "type": "command",
          "command": "C:/Python313/python.exe C:/Vault/YourName/.claude/scripts/auto-wrapup.py"
        }]
      },
      // 8. 화장품법 위반 표현 차단 (향수 사업용, 필요 없으면 제거)
      {
        "hooks": [{
          "type": "command",
          "command": "node C:/Vault/YourName/.claude/scripts/check-cosmetic-law.js"
        }]
      }
    ]
  }
}

훅 스크립트 상세 — 6개 설계 예시

① session-start.py — 세션 시작 컨텍스트 로더

역할: 매 세션 시작 시 North Star, 활성 프로젝트, 최근 git 로그, 미완료 태스크, Graphify 상태, QMD 인덱스를 Claude에게 자동으로 주입합니다.

# -*- coding: utf-8 -*-
import subprocess, os, sys, io

sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8")

vault = "C:/Vault/YourName"  # ← 본인 경로로 수정
output_parts = []

# North Star 로딩
ns_path = os.path.join(vault, "brain", "North Star.md")
if os.path.exists(ns_path):
    with open(ns_path, "r", encoding="utf-8") as f:
        output_parts.append("=== NORTH STAR ===")
        output_parts.append(f.read().strip())

# Active Work 스캔
active_dir = os.path.join(vault, "work", "active")
if os.path.isdir(active_dir):
    files = [f for f in os.listdir(active_dir) if f.endswith(".md")]
    if files:
        output_parts.append("=== ACTIVE WORK ===")
        output_parts.append(", ".join(files))

# 최근 Git 변경사항
try:
    result = subprocess.run(["git", "log", "--oneline", "-10"],
        capture_output=True, text=True, cwd=vault, timeout=5, encoding="utf-8")
    if result.stdout.strip():
        output_parts.append("=== RECENT CHANGES ===")
        output_parts.append(result.stdout.strip())
except Exception:
    pass

# 미완료 태스크 탐색
for search_dir in [os.path.join(vault, "brain"), active_dir]:
    if os.path.isdir(search_dir):
        for root, dirs, files in os.walk(search_dir):
            for fname in files:
                if fname.endswith(".md"):
                    fpath = os.path.join(root, fname)
                    try:
                        with open(fpath, "r", encoding="utf-8") as f:
                            for i, line in enumerate(f, 1):
                                if "- [ ]" in line:
                                    if "=== OPEN TASKS ===" not in output_parts:
                                        output_parts.append("=== OPEN TASKS ===")
                                    output_parts.append(f"{fname}:{i}: {line.strip()}")
                    except Exception:
                        pass

# Graphify 상태
graph_report = os.path.join(vault, "graphify-out", "GRAPH_REPORT.md")
if os.path.exists(graph_report):
    output_parts.append("=== GRAPHIFY ===")
    output_parts.append("Graph report available: graphify-out/GRAPH_REPORT.md")
else:
    output_parts.append("=== GRAPHIFY ===")
    output_parts.append("No graph yet. Run '/graphify .' to build.")

# QMD 인덱스 갱신
try:
    qmd_cmd = os.path.join(vault, "qmd.cmd")
    if os.path.exists(qmd_cmd):
        subprocess.run([qmd_cmd, "update"], capture_output=True, cwd=vault, timeout=30)
        output_parts.append("=== QMD ===")
        output_parts.append("QMD index updated.")
except Exception:
    pass

print("\n".join(output_parts) if output_parts else "(no vault data yet)")

② classify-message.py — 메시지 자동 라우팅

역할: 사용자가 입력한 메시지를 분석해 어느 폴더에 저장해야 할지 힌트를 Claude에게 제공합니다. 결정/성과/미팅/아이디어/문제/사람을 자동 감지합니다.

# -*- coding: utf-8 -*-
import os, sys, json

content = os.environ.get("CLAUDE_USER_CONTENT", "")
if not content:
    print(json.dumps({"decision": "approve"}))
    sys.exit(0)

lower = content.lower()
hints = []

# 분류 규칙 — 키워드 기반
if any(w in lower for w in ["결정", "decision", "선택", "확정"]):
    hints.append("decision -> brain/Key Decisions.md + work/ note")
if any(w in lower for w in ["성과", "완료", "달성", "win", "성공"]):
    hints.append("win -> perf/Brag Doc.md")
if any(w in lower for w in ["미팅", "회의", "1on1", "1:1"]):
    hints.append("meeting -> work/1-1/ or work/meetings/")
if any(w in lower for w in ["사람", "person", "팀원", "동료"]):
    hints.append("person -> org/people/")
if any(w in lower for w in ["아이디어", "idea", "생각"]):
    hints.append("idea -> thinking/ then promote")
if any(w in lower for w in ["문제", "버그", "에러", "incident"]):
    hints.append("incident -> brain/Gotchas.md")

if hints:
    result = {"hookSpecificOutput": {"additionalContext": "Routing hints: " + "; ".join(hints)}}
    print(json.dumps(result, ensure_ascii=False))
else:
    print(json.dumps({"decision": "approve"}))

③ validate-write.py — 노트 품질 자동 검증

역할: .md 파일을 쓸 때마다 자동으로 frontmatter와 wikilink 존재 여부를 검사합니다. 누락 시 경고를 출력합니다.

# -*- coding: utf-8 -*-
import sys, os

filepath = os.environ.get("CLAUDE_FILE_PATH", "")
if not filepath or not filepath.endswith(".md"): sys.exit(0)
if not os.path.exists(filepath): sys.exit(0)

content = None
for enc in ["utf-8", "cp949"]:
    try:
        with open(filepath, "r", encoding=enc) as f:
            content = f.read()
        break
    except: continue
if content is None: sys.exit(0)

issues = []
if not content.startswith("---"): issues.append("frontmatter missing")
if "[[" not in content: issues.append("no wikilink")

print(f"[VALIDATE] {filepath}: {'; '.join(issues)}" if issues else "[VALIDATE] OK")

④ pre-compact.py — 세션 로그 백업의 시작점(예시)

주의: 아래 예시는 로그 파일의 제목만 만들며 대화 본문을 백업하지 않습니다. 실제 세션 백업에는 transcript_path 등 공식 훅 입력을 읽는 추가 구현과 개인정보 보호 조치가 필요합니다.

# -*- coding: utf-8 -*-
import datetime, os

log_dir = r"C:\Vault\YourName\thinking\session-logs"  # ← 경로 수정
os.makedirs(log_dir, exist_ok=True)
ts = datetime.datetime.now().strftime("%Y-%m-%d-%H%M")
path = os.path.join(log_dir, f"session-{ts}.md")
with open(path, "w", encoding="utf-8") as f:
    f.write(f"---\ndate: {ts[:10]}\ndescription: session log\ntags: [session-log]\n---\n# Session {ts}\n")
print(f"[BACKUP] {path}")

⑤ auto-wrapup.py — 세션 종료 자동 커밋

역할: Stop 훅에 연결. frontmatter 누락 파일, 고아 노트, 변경 파일을 스캔하고 자동으로 git commit합니다.

⑥ block-sensitive-files.js — 민감 파일 쓰기 차단

역할: Claude가 .env, .key, *.pem 등 민감한 파일을 실수로 수정하는 것을 막습니다. PreToolUse Write|Edit 훅에 연결합니다.

const filepath = process.env.CLAUDE_FILE_PATH || "";
const blocked = [".env", ".key", ".pem", ".secret", "id_rsa", "credentials"];

if (blocked.some(ext => filepath.endsWith(ext) || filepath.includes(ext))) {
  console.log(JSON.stringify({
    decision: "block",
    reason: `Blocked sensitive file write: ${filepath}`
  }));
} else {
  console.log(JSON.stringify({ decision: "approve" }));
}

5 Skills 구성

Skills는 Claude에게 특정 도메인 지식을 주입하는 SKILL.md 파일들입니다. .claude/skills/스킬명/SKILL.md 형태로 저장합니다.

karpathy-loop SKILL.md 예시

---
name: karpathy-loop
description: Karpathy LLM Wiki 패턴 — compile, lint, filing-back
---

# Karpathy Loop

## 파이프라인
소스 문서 → raw/ → /compile → wiki/ (개념, 엔티티, 인덱스)
wiki/ → /lint-wiki → 불일치 → 웹 검색 보완 → wiki/ 갱신
질문 → wiki/ 탐색 → 답변 → output/
출력물 → wiki/index.md 재등록 (자기 강화 루프)

## /compile 절차
1. raw/에서 미처리 소스 탐지
2. 소스 읽기 → 핵심 정보 추출
3. wiki/ 요약 페이지 작성 (frontmatter 필수)
4. wiki/index.md 업데이트
5. 관련 엔티티·컨셉 페이지 업데이트
6. wiki/log.md에 기록

## Filing-Back
Q&A 답변 중 가치 있는 것:
output/answers/ → wiki/ 승격 → index+log 업데이트

6 Slash Commands (19개)

각 커맨드는 .claude/commands/커맨드명.md 파일로 정의합니다. Claude Code에서 /커맨드명으로 호출합니다.

매일 사용 — 핵심 5개

유지보수 — 4개

성과 관리 — 2개

자동화 — 5개

기타 — 3개

커맨드 파일 작성 예시

# /standup - 모닝 스탠드업
1. brain/North Star.md 읽기 후 현재 목표 확인
2. work/active/ 전체 스캔 후 진행 중 프로젝트 상태
3. git log --oneline -15 로 최근 변경사항
4. grep -rn "\- \[ \]" brain/ work/active/ 로 미완료 작업
5. 위 정보를 종합해 오늘 추천 우선순위 3가지 제시
6. 한국어로 출력

Format:
## 오늘의 스탠드업
### 활성 프로젝트
### 미완료 작업
### 오늘 추천 우선순위

7 QMD — 한국어 시맨틱 검색

QMD는 로컬 검색 도구입니다. 기본 임베딩 모델은 영어 중심일 수 있으므로 한국어 검색은 모델 설정과 자료에 따라 성능이 달라집니다. grep과 달리 의미 기반으로 유사한 노트를 찾아줍니다.

설치

# 1. 설치
npm install -g @tobilu/qmd

# 2. Vault에서 초기 인덱싱
cd C:\Vault\YourName
qmd collection add . --name myvault
qmd embed


# 3. 설치 경로 확인 — 직접 래퍼 파일을 만들지 마세요
# qmd 명령이 실행되지 않으면 설치 상태와 PATH 확인
where.exe qmd

사용법

8 Graphify — 지식 그래프

Graphify는 Vault의 모든 노트를 분석해 노드(개념)와 엣지(관계)로 구성된 지식 그래프를 생성합니다. Claude가 파일을 직접 읽지 않고 그래프를 통해 구조를 파악하게 합니다.

설치 및 초기화

# 1. Windows PowerShell에서 (uv 사전 설치 필요)
uv tool install graphifyy
graphify install

# 2. Claude Code 안에서 실행
/graphify .

# 그래프 빌드 완료 후 생성 파일:
# graphify-out/GRAPH_REPORT.md  ← 요약 (세션 시작 시 자동 로딩)
# graphify-out/graph.json        ← 원본 그래프 데이터
# graphify-out/wiki/index.md     ← 파일 맵

CLAUDE.md에 graphify 섹션 추가

## graphify

This project has a graphify knowledge graph at graphify-out/.

Rules:
- Before answering architecture or codebase questions,
  read graphify-out/GRAPH_REPORT.md for god nodes and community structure
- If graphify-out/wiki/index.md exists, navigate it instead of reading raw files
- After modifying code files in this session, run
  follow the installed Graphify instructions to refresh the graph when files change

9 defuddle — 웹 아티클 파싱

defuddle은 웹 URL을 클린 마크다운으로 변환하는 CLI 도구입니다. 광고, 네비게이션 등 불필요한 요소를 제거하고 본문만 추출합니다.

# 설치
npm install -g defuddle

# 웹 아티클 → raw/articles/ 저장 (기본 사용법)
defuddle parse "https://example.com/article" --md > raw/articles/아티클제목.md

# 제목을 자동으로 파일명으로 사용하고 싶다면
defuddle parse "URL" --md | tee raw/articles/$(date +%Y-%m-%d)-article.md

10 Telegram 봇 설치 및 설정

Telegram 봇은 모바일에서 Vault에 접근하는 유일한 인터페이스입니다. 이동 중 텍스트/이미지를 던지면 자동으로 Vault에 저장됩니다.

1단계: Telegram 봇 생성

1. 1
   Telegram에서 @BotFather를 검색 → /newbot 명령 실행
2. 2
   봇 이름 입력 (예: "My Vault Bot") → 사용자명 입력 (예: "ys_vault_bot")
3. 3
   발급된 API 토큰을 복사 (절대 코드에 직접 입력 금지)
4. 4
   환경변수로 저장:

   PowerShell (관리자)ps1

   setx VAULT_TG_TOKEN "여기에-토큰-붙여넣기" /M
   # PC 재시작 후 적용됨

5. 5
   본인 chat_id 확인: 봇과 대화 후 https://api.telegram.org/bot[토큰]/getUpdates 에서 확인

2단계: telegram-bot.py 핵심 설정

# ─── 수정 필요 항목 ────────────────────────────
BOT_TOKEN = os.environ.get("VAULT_TG_TOKEN", "")  # 환경변수에서 자동 로딩
VAULT = "C:/Vault/YourName"                        # ← 본인 경로로 수정
ALLOWED_USERS: set[int] = {123456789}               # ← 본인 chat_id로 수정

# 봇 명령어 구조:
# /start      → 사용법 안내
# /standup    → North Star + active work 요약
# /dump 텍스트 → thinking/session-logs/dump-날짜-시간.md 저장
# /wiki 키워드 → wiki/ 검색 + 첫 매치 전송
# /status     → Vault 통계 (총 노트 수, 폴더별)
# /topics     → raw/images/ 주제 폴더 목록
# 일반 텍스트  → 자동 /dump 처리
# 이미지+캡션  → #주제/하위 형식이면 해당 폴더에 저장

3단계: 자동 시작 설정

@echo off
:: vault-bot.bat — PC 부팅 시 자동 실행
start /B "Vault Telegram Bot" C:\Python313\python.exe "C:\Vault\YourName\.claude\scripts\telegram-bot.py"
exit

이미지 태그 규칙

11 일상 운영 가이드

아침 루틴

# 1. Vault 폴더에서 Claude Code 실행
cd C:\Vault\YourName
claude

# → SessionStart 훅이 자동으로 실행되며:
#   - North Star 로딩
#   - Active projects 스캔
#   - 최근 git 변경사항
#   - 미완료 태스크
#   - Graphify + QMD 상태

# 2. 오늘 우선순위 확인
/standup

리서치 워크플로우

1. 1
   웹 아티클 저장
   defuddle parse "https://example.com/article" --md > raw/articles/아티클제목.md
2. 2
   Claude와 내용 대화
   Claude Code에서 저장된 파일에 대해 자유롭게 질문 및 토론
3. 3
   위키로 정제
   /compile 실행 → wiki/에 인사이트 노트 자동 생성 (source 링크 포함)
4. 4
   교차 연결
   /cross-linker로 관련 노트와 wikilink 자동 연결

노트 작성 컨벤션

모든 .md 파일은 아래 형식을 따라야 합니다. validate-write.py 훅이 자동으로 검사합니다.

---
date: 2026-04-13
description: 이 노트가 다루는 내용 한 줄 요약
tags: [concept, business, strategy]
source: raw/articles/원본파일명.md   # wiki/ 노트에만 필수
---

# 노트 제목

본문 내용. [[관련 노트]]와 [[다른 노트]]를 반드시 연결.

> [!note] Callout 예시
> Obsidian callout 사용 가능

[unverified] 태그는 확인이 필요한 정보에 사용.

퇴근 전 루틴

# 세션 마무리 — frontmatter 검증 + 자동 커밋
/wrap-up

# Stop 훅(auto-wrapup.py)이 자동으로:
# - 전체 .md 스캔 (frontmatter, wikilink 검증)
# - 변경사항 git add -A
# - auto: wrap-up [날짜] 메시지로 자동 커밋
# - 요약 출력

주간/월간 유지보수

★ 법인/개인 분리 아키텍처

사업이 성장하면서 법인 데이터와 개인 지식을 동일한 Vault에 섞는 것은 법적·전략적으로 모두 문제가 됩니다. 동시에, CEO는 법인의 모든 맥락을 알아야 합니다. 이 구조는 두 조건을 동시에 충족합니다.

왜 분리해야 하는가

단방향 동기화 구조 상세

Corp Vault 폴더 구조

C:\Vault\Corp\
│
├── CLAUDE.md                      ← 법인 전용 시스템 헌법
│
├── raw/                           ← 원본 (IMMUTABLE, 개인에게 절대 동기화 안 함)
│   ├── contracts/                 ← 계약서 원본 스캔본
│   ├── customers/                 ← 고객 데이터 원본 (PII 포함)
│   ├── financials/                ← 재무 자료 원본
│   ├── legal/                     ← 인허가·법무 문서
│   ├── ir/                        ← IR 자료 원본
│   └── research/                  ← 시장 리서치 원본
│
├── wiki/                          ← Claude가 생성 — 이것만 개인 Vault로 동기화
│   ├── index.md                   ← 전체 인덱스
│   ├── concepts/                  ← 사업 개념 정의 (온톨로지 Object Types)
│   │   ├── product-definition.md
│   │   ├── market-positioning.md
│   │   └── revenue-model.md
│   ├── entities/                  ← 핵심 엔티티 (온톨로지 Objects)
│   │   ├── customers/             ← 고객사 프로필 (익명화 버전)
│   │   ├── partners/              ← 파트너사
│   │   └── competitors/           ← 경쟁사
│   ├── decisions/                 ← 의사결정 기록 (온톨로지 Events)
│   │   ├── product-decisions.md
│   │   ├── hiring-decisions.md
│   │   └── strategy-pivots.md
│   ├── metrics/                   ← KPI·지표 현황 (온톨로지 Properties)
│   │   ├── revenue.md
│   │   ├── user-metrics.md
│   │   └── unit-economics.md
│   └── playbooks/                 ← 운영 플레이북 (재사용 가능 절차)
│       ├── sales-playbook.md
│       ├── onboarding-playbook.md
│       └── incident-response.md
│
├── org/
│   ├── people/                    ← 팀원 프로필 (개인 Vault 동기화 제외)
│   └── structure.md               ← 조직도
│
├── work/
│   ├── active/                    ← 진행 중 법인 프로젝트
│   └── archive/                   ← 완료 프로젝트
│
├── graphify-out/                  ← 법인 지식 그래프 (corp-sync로 전달)
│
└── .claude/
    ├── commands/                  ← 법인 전용 커맨드
    ├── scripts/
    │   ├── session-start.py       ← 법인 컨텍스트 로더
    │   └── corp-to-personal-sync.py  ← 단방향 동기화 스크립트
    └── skills/

Corp CLAUDE.md 템플릿

법인 Vault의 CLAUDE.md는 개인 Vault와 독립적입니다. 개인 Vault 경로에 대한 참조가 전혀 없어야 합니다.

# CLAUDE.md — Corp Vault 운영 매뉴얼

## 법인 정체성
[법인명]. [사업 영역] 운영.
이 Vault는 법인 전용입니다. 개인 정보는 이 Vault에 절대 포함되지 않습니다.

## 3-Layer 불변 규칙
- **raw/** = 원본 기업 데이터. IMMUTABLE. LLM 읽기만. 외부 동기화 절대 금지.
- **wiki/** = LLM 생성 인사이트. 이것만 개인 Vault와 공유 가능.
- **CLAUDE.md** = 공동 관리 스키마.

## 데이터 분류 정책
- CONFIDENTIAL: raw/ 전체, org/people/, 재무 원본 → 외부 동기화 금지
- INTERNAL: wiki/ 전체, graphify-out/ → corp-to-personal-sync.py로만 동기화 허용
- 개인(YS) Vault 경로를 이 Vault에서 절대 참조하지 않음

## 온톨로지 구조 (Object Types)
- **Concepts** (wiki/concepts/) = 사업 개념 정의. 변하지 않는 지식.
- **Entities** (wiki/entities/) = 고객·파트너·경쟁사. 실세계 객체.
- **Decisions** (wiki/decisions/) = 언제, 왜, 무엇을 결정했는가.
- **Metrics** (wiki/metrics/) = 측정 가능한 사업 현황.
- **Playbooks** (wiki/playbooks/) = 재사용 가능한 운영 절차.

## 핵심 규칙
- 모든 .md에 YAML frontmatter 필수 (date, description, tags, classification)
- classification 필드: CONFIDENTIAL / INTERNAL / PUBLIC 중 하나
- 고객 PII는 wiki/ 노트에 포함 금지. 익명화 또는 식별자만 사용.
- 모든 결정 기록에 의사결정자, 날짜, 대안, 이유 포함.

## Context Navigation
1. graphify-out/GRAPH_REPORT.md 먼저 확인
2. wiki/index.md로 전체 구조 파악
3. QMD로 검색 후 파일 직접 읽기
4. raw/ 는 명시적 요청 시에만 읽기

단방향 동기화 스크립트 (보안 검토용 예시)

이 스크립트는 Corp Vault의 wiki/를 Personal Vault의 raw/corp-sync/로 복사합니다. 역방향은 구조적으로 불가능합니다.

# -*- coding: utf-8 -*-
"""
corp-to-personal-sync.py
단방향 동기화: Corp Vault wiki/ → Personal Vault raw/corp-sync/

규칙:
  - INTERNAL 등급(wiki/) 만 복사. raw/, org/people/ 는 절대 복사 금지.
  - 복사된 파일은 Personal Vault에서 raw/ 취급 — 수정 금지.
  - 역방향(Personal → Corp)은 이 스크립트에 없음. 코드로 불가능하게 설계.
"""
import os, shutil, json
from pathlib import Path
from datetime import datetime

# ─── 경로 설정 ── 본인 환경에 맞게 수정 ───────────
CORP_VAULT   = Path("C:/Vault/Corp")
PERSONAL_VAULT = Path("C:/Vault/Personal")
SYNC_TARGET  = PERSONAL_VAULT / "raw" / "corp-sync"

# Corp에서 동기화 허용할 폴더 (INTERNAL 등급만)
ALLOWED_SOURCES = [
    CORP_VAULT / "wiki",
    CORP_VAULT / "graphify-out" / "GRAPH_REPORT.md",
]

# 절대 복사하지 않을 패턴 (CONFIDENTIAL)
BLOCKED_PATTERNS = [
    "raw/", "org/people", "org/hr",
    ".claude/", ".git/", ".obsidian/",
    "financials", "contracts", "customers",
]

def is_blocked(path: Path) -> bool:
    path_str = str(path).replace("\\", "/").lower()
    return any(pat in path_str for pat in BLOCKED_PATTERNS)

def sync():
    SYNC_TARGET.mkdir(parents=True, exist_ok=True)
    synced, blocked = [], []

    for source in ALLOWED_SOURCES:
        if not source.exists():
            continue

        if source.is_file():
            # 단일 파일 (e.g. GRAPH_REPORT.md)
            if is_blocked(source):
                blocked.append(str(source))
                continue
            dst = SYNC_TARGET / source.name
            shutil.copy2(source, dst)
            synced.append(str(dst))
        else:
            # 폴더 재귀 복사
            for src_file in source.rglob("*.md"):
                if is_blocked(src_file):
                    blocked.append(str(src_file))
                    continue
                rel = src_file.relative_to(CORP_VAULT)
                dst = SYNC_TARGET / rel
                dst.parent.mkdir(parents=True, exist_ok=True)
                shutil.copy2(src_file, dst)
                synced.append(str(dst))

    # 동기화 메타 기록
    meta_path = SYNC_TARGET / "_sync-log.md"
    ts = datetime.now().strftime("%Y-%m-%d %H:%M")
    with open(meta_path, "w", encoding="utf-8") as f:
        f.write(
            f"---\ndate: {ts[:10]}\ndescription: Corp→Personal 동기화 로그\n"
            f"tags: [corp-sync, auto]\n---\n"
            f"# Corp Sync Log — {ts}\n\n"
            f"동기화: {len(synced)}개\n차단: {len(blocked)}개\n\n"
            f"## 동기화된 파일\n" + "\n".join(f"- {p}" for p in synced[:30])
        )
    print(f"[CORP-SYNC] {len(synced)}개 동기화 완료 → {SYNC_TARGET}")
    print(f"[CORP-SYNC] {len(blocked)}개 차단 (CONFIDENTIAL)")

if __name__ == "__main__":
    sync()

동기화 자동 실행 — Corp Vault Stop 훅에 등록

// Corp Vault 전용 settings.json 또는 .claude/settings.json
{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        // 세션 종료 시 Corp → Personal 자동 동기화
        "command": "C:/Python313/python.exe C:/Vault/Corp/.claude/scripts/corp-to-personal-sync.py"
      }]
    }]
  }
}

온톨로지 구축과 기업가치 검토

지식과 업무 자료를 정리하면 인수실사·인수인계에 도움이 될 수 있지만 매각 배수 상승을 보장하지는 않습니다.

팔란티어 Foundry vs. 이 시스템 비교

매각 배수에 직접 영향을 미치는 3가지 메커니즘

Corp Vault 구축 우선순위 — "M&A 가치 기여 순"

설치 순서 — 법인/개인 분리 구조 구축

1. 1
   Corp Vault 폴더 생성
   mkdir C:\Vault\Corp + 위 폴더 구조 생성
2. 2
   별도 Git repo 초기화
   cd C:\Vault\Corp && git init → GitHub private repo 연결. 개인 repo와 완전히 분리.
3. 3
   Corp CLAUDE.md 작성
   위 템플릿 기반. 개인 Vault 경로 참조 없이 법인 규칙만 기술.
4. 4
   Claude Code에서 Corp 프로젝트로 열기
   cd C:\Vault\Corp && claude — 개인 Vault와 별도의 Claude 세션/컨텍스트 유지.
5. 5
   corp-to-personal-sync.py 설치
   C:\Vault\Corp\.claude\scripts\에 저장 → Corp Vault Stop 훅에 등록.
6. 6
   Personal Vault CLAUDE.md에 corp-sync 참조 추가

   ## Corp Data
   - raw/corp-sync/ 에 법인 wiki 요약이 자동 동기화됨
   - 이 폴더는 읽기 전용 (raw/ 규칙 적용)
   - Corp 컨텍스트가 필요할 때: qmd query "검색어"
     또는 raw/corp-sync/wiki/ 직접 참조

7. 7
   우선순위 순서대로 소급 기록 시작
   1순위(decisions) → 2순위(metrics) → 3순위(playbooks) 순으로 지금까지의 기록을 소급 입력. Graphify는 노트 30개 이상 쌓인 후 실행.

12 트러블슈팅 & 알려진 이슈

잘못 저장된 파일 삭제 방법

:: 이미지 파일 삭제
del raw\images\주제폴더\파일명.jpg

:: 폴더 전체 삭제
rmdir /s /q raw\images\주제폴더

:: 세션 로그 삭제
del thinking\session-logs\dump-2026-04-13-*.md

:: 삭제 후 반드시 git 커밋
git add -A
git commit -m "cleanup: 불필요한 파일 삭제"
git push

새 도구/기능 추가 절차

1. 1
   스킬 파일 생성 (선택사항)
   .claude/skills/도구명/SKILL.md — 도구 사용법 작성
2. 2
   슬래시 커맨드 생성 (선택사항)
   .claude/commands/커맨드명.md — 절차 작성
3. 3
   훅 스크립트 추가 (선택사항)
   .claude/scripts/스크립트.py 생성 → settings.json에 훅 포인트 등록
4. 4
   CLAUDE.md 업데이트
   새 도구/규칙을 CLAUDE.md의 적절한 섹션에 추가
5. 5
   Git 커밋
   git add -A && git commit -m "feat: 새 도구 추가" && git push

13 시나리오별 단계 가이드

실제로 마주치는 상황별로 정확히 어떤 순서로 무엇을 해야 하는지 단계별로 설명합니다.

시나리오 A — 웹 아티클 읽고 인사이트 위키로 만들기

예: "GPT-5 발표 기사를 읽고 우리 SaaS 전략에 반영할 인사이트를 뽑고 싶다"

1. 1
   아티클을 raw/에 저장

   defuddle parse "https://openai.com/gpt-5-announcement" --md > raw/articles/2026-04-14-gpt5.md

   raw/ 는 절대 수정하지 않는 원본 저장소. 이 파일은 읽기 전용이 됩니다.
2. 2
   Claude와 내용 대화
   Claude Code에서 자유롭게 질문:

   raw/articles/2026-04-14-gpt5.md 를 읽고 우리 example-service 아키텍처 결정에
   영향을 줄 수 있는 포인트만 뽑아줘

3. 3
   /compile 실행 → wiki 생성

   /compile

   Claude가 raw/articles/의 새 파일을 감지하고 자동으로:
   → wiki/concepts/gpt5-implications.md 생성 (source: raw/articles/2026-04-14-gpt5.md)
   → wiki/index.md 업데이트
   → 기존 관련 노트(예: example-service.md)에 wikilink 추가 제안
4. 4
   /cross-linker 실행 (선택)

   /cross-linker

   새 wiki 노트와 기존 노트 간 누락된 wikilink를 자동으로 탐색해 연결 제안.
5. 5
   /wrap-up으로 커밋

   /wrap-up

   frontmatter 검증 + 자동 git commit. 오늘 추가된 내용이 영구 보존됩니다.

시나리오 B — 중요한 의사결정 기록하기

예: "example-service 기술스택을 Next.js + Supabase로 결정했다"

1. 1
   Claude에게 결정 사항 말하기

   example-service 기술스택을 Next.js + Supabase로 확정했어.
   이유는 팀 학습 곡선과 BaaS 비용 최적화 때문이야.

   classify-message.py 훅이 자동으로 감지: "결정" 키워드 → "decision → brain/Key Decisions.md + work/ note" 힌트를 Claude에게 전달
2. 2
   Claude가 자동으로 두 곳에 기록
   → brain/Key Decisions.md에 결정 추가 (날짜, 결정 내용, 이유, 트레이드오프)
   → work/active/example-service.md의 관련 섹션 업데이트
3. 3
   wikilink 연결 확인
   Key Decisions.md ↔ example-service.md ↔ wiki/concepts/nextjs.md 가 연결되어 있는지 확인.
   없으면 Claude에게 직접 요청: "방금 결정 내용에 관련 wikilink 추가해줘"

시나리오 C — 미팅 내용 기록하고 아카이빙

예: "투자자와 IR 미팅을 했고, 핵심 피드백을 기록해야 한다"

1. 1
   모바일에서 실시간 메모 (이동 중, 미팅 중)
   Telegram으로 텍스트 전송:

   투자자 김OO 미팅. PMF 증거 더 필요하다고. 6개월 내 100 유료 유저 목표로 잡아보라 했음.

   → thinking/session-logs/dump-날짜.md에 자동 저장
2. 2
   PC에서 미팅 노트 정식화

   방금 덤프한 투자자 미팅 내용을 work/1-1/ 에 정식 미팅 노트로 만들어줘.
   frontmatter, wikilink([[example-website]], [[brain/North Star]]) 포함해서.

3. 3
   /people-profiler 업데이트

   /people-profiler

   "김OO 투자자" 프로필이 org/people/에 없으면 자동 생성. 있으면 미팅 이력 추가.
4. 4
   핵심 피드백을 North Star에 반영
   투자자 피드백이 방향에 영향을 준다면: brain/North Star.md 업데이트 → work/active/example-website.md 다음 스텝 갱신

시나리오 D — 경쟁사 분석 진행하기

예: "향수 브랜드의 주요 경쟁사 3곳 분석을 vault에 체계적으로 쌓고 싶다"

1. 1
   경쟁사 원본 자료 수집

   # 각 경쟁사 페이지를 raw/에 저장
   defuddle parse "https://competitor-a.com/about" --md > raw/competitors/competitor-a.md
   defuddle parse "https://competitor-b.com/products" --md > raw/competitors/competitor-b.md

   Telegram으로 이미지도 전송: #brand/competitors 캡션으로 raw/images/brand/competitors/ 자동 저장
2. 2
   비교 분석 대화

   raw/competitors/ 폴더의 파일들을 읽고 향수 브랜드 관점에서
   포지셔닝, 가격대, 채널 전략을 비교 분석해줘

3. 3
   /compile → 경쟁사 wiki 생성

   /compile

   → wiki/entities/competitor-a.md, wiki/entities/competitor-b.md 생성
   → wiki/concepts/perfume-competitive-landscape.md 생성 (전체 지형도)
4. 4
   향후 검색은 QMD로

   qmd query "향수 브랜드 경쟁사 가격 전략"

   새 경쟁사 정보가 추가될 때마다 같은 흐름 반복. 시간이 지날수록 비교 분석이 풍부해집니다.

14 커맨드 맥락 가이드 — 언제 어떤 커맨드를?

19개 커맨드를 어떤 상황에서 사용하면 되는지 맥락 중심으로 정리합니다.

커맨드 조합 패턴 (자주 쓰이는 시퀀스)

15 지식 축적 흐름 — 시간이 지나면 어떻게 되는가

이 시스템은 사용할수록 지식이 복리로 쌓이도록 설계되어 있습니다. 아래는 동일한 Vault가 1주차, 1개월차, 3개월차에 어떤 모습이 되는지 보여줍니다.

지식 흐름 다이어그램

시간별 Vault 변화

Karpathy 루프 — 지식이 스스로 강화되는 원리

16 처음 2주 온보딩 플랜

시스템을 새로 설치했다면 이 순서대로 진행하세요. 한꺼번에 다 하려 하지 말고, 하루에 한 가지씩 익히는 것이 핵심입니다.

1주차 — 기초 습관 형성

2주차 — 심화 활용

✦ 전체 시스템 수치 요약

핵심 파일 경로 체크리스트