cc-llm-wiki
Karpathy 의 LLM Wiki 원전부터 Neo4j GraphRAG PoC 까지 11 개 설계 문서를 통합한
Claude Code 중심 로컬 전용 LLM Wiki.
무엇
- Obsidian vault + Claude Code 9 Skills + Neo4j 그래프의 통합 환경
- 외부 공개·발신 없는 로컬 전용 (Cloudflare 등 publish 라인 제외)
- 자료가 쌓일수록 복리로 성장하는 지식 베이스 (요약 자동화 아님)
빠른 시작
Plugin 경로 (권장, v0.2.0+)
mkdir ~/my-knowledge-base && cd ~/my-knowledge-base
claude # Claude Code 세션
세션 안에서:
/plugin marketplace add gaebalai/cc-llm-wiki
/plugin install cc-llm-wiki@claudecode-to-marketplace
/install
→ install.sh 가 PLUGIN_INSTALL 자동 감지 → 템플릿을 ~/my-knowledge-base/ 로 복사 + 사용자 .claude/settings.json 에 Hook 안전 머지.
git clone 경로 (v0.1.0 또는 plugin 없이)
git clone https://github.com/gaebalai/cc-llm-wiki.git ~/cc-llm-wiki
cd ~/cc-llm-wiki
bash scripts/install.sh
자세한 단계별 가이드: QUICKSTART.md ← 첫 사용자는 여기부터
핵심 원칙
- 3 층 격리 —
vault/01_raw/(불변) · vault/02_wiki/(LLM 편찬) · vault/SCHEMA.md(사람 규율)
- 단방향 흐름 — raw → wiki → graph (역방향 쓰기 금지)
- 컨텍스트 위생 — raw 읽기 전용 강제, JIT 검색, 인간 승인 게이트
디렉터리
cc-llm-wiki/
├── CLAUDE.md # 헌법 (11 섹션)
├── QUICKSTART.md # ← 첫 사용자 가이드
├── README.md # 본 파일
│
├── .claude-plugin/ # Plugin marketplace + manifest
│ ├── marketplace.json
│ └── plugin.json
├── .claude/
│ ├── skills/ # 8 활성 (ingest·lint·compile·query·graph-sync·morning-brief·evening-reflect·daily-digest)
│ ├── commands/ # /install
│ ├── routines/ # weekly-lint·weekly-review·wiki-ingest-sweep·sleep-maintenance·daily-digest (5 active)
│ ├── queue/ # PostToolUse hook 이 graph 큐 적재
│ ├── settings.json # 공유 (Hook·permissions)
│ └── settings.local.json # 개인 (글로벌 ignore)
│
├── vault/
│ ├── 01_raw/ # 원전 보존 (Read-Only Hook)
│ ├── 02_wiki/
│ │ ├── self/ # 비공개, 어디에도 노출 금지
│ │ ├── decisions/ # ADR (append-only)
│ │ ├── topics/ # 지식 노드 (현재 3 건)
│ │ ├── digests/ # daily-digest routine 산출
│ │ ├── _drafts/ # ingest 임시 산출
│ │ └── _lint/ # 주간 lint 리포트
│ ├── 03_schema/aliases.yaml # entity 정규화 (18 canonical / 60 aliases)
│ ├── 03_schema/eval-gold/ # P/R/F1 정답셋 (사람 검수 보강)
│ ├── SCHEMA.md # 사서 규율 (5 섹션)
│ ├── index.md # 카탈로그
│ ├── log.md # 모든 LLM 행동 기록
│ └── dashboards/status.md # Dataview 6 쿼리
│
├── infra/neo4j/ # docker-compose.yml (Neo4j 5.18.1 + APOC)
├── services/graph/ # ingest_graph/ingest_llm/ingest_merge/eval.py + templates
├── scripts/ # install.sh / post_slack.py / daily_digest_runner.py
├── docs/ # 11 개 설계 문서 (gitignore)
└── docs-internal/ # 저자용 (PUBLISH.md)
활성 자산
| 영역 | 자산 | 비고 |
|---|
| Skill | ingest · lint · compile · query · graph-sync · morning-brief · evening-reflect · daily-digest | 8 종 (v0.3.0+) |
| Command | /install | 7+1 단계 원스톱 installer (PLUGIN_INSTALL 자동 감지) |
| Routine | weekly-lint (일 06:00) · weekly-review (일 21:00) · wiki-ingest-sweep (매시) · sleep-maintenance (매일 03:00) · daily-digest (매일 07:00) | KST cron, 5 active (v0.4.3+) |
| Hook | PreToolUse (raw·main 차단) · PostToolUse (graph 큐) · SessionStart · UserPromptSubmit · Stop | 5 종 (v0.3.0+) |
| 인프라 | Neo4j 5.18.1 + APOC (Docker) | dry-run 가능, 실 검증 완료 (v0.3.1) |
| 검색 | Cypher 템플릿 3 종 (causal_path / concept_neighbors / orphan_audit) | 고정 템플릿만 |
| GraphRAG | 룰베이스 (ingest_graph.py) + LangChain LLM (ingest_llm.py) + 머지 (ingest_merge.py) | v0.4.0+, SOLVES/USES 의미 관계 |
| 평가 | P/R/F1 자동 측정 (services/graph/eval.py) + gold YAML | v0.4.2+, CI 통합 (10 항목) |
| daily-digest | positioning.md 의존 + 5 쿼리 자동 설계 (daily_digest_runner.py) | v0.4.3+, Slack 옵션 |
| vault 컨벤션 | flat (TARGET_DIR 자체) 또는 subdir (TARGET_DIR/vault) | v0.3.6+ 자동 감지 (Obsidian 친화 = flat 기본) |
Phase 로드맵
