From 76ba697a64473e07a1979968085b20e6a97486d8 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:28:25 +0900
Subject: [PATCH 01/21] docs(issues/8): add SPEC for llm-wiki skill (Karpathy +
 qmd + LanceDB) (#8)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Phase 2 scope: qmd 필수 통합 + LanceDB 선택. 단일 스킬에 8개 서브커맨드.
wiki/ 노출형 디렉토리, wjtb-cmc 스킬 포팅 + 일반화, graceful degrade UX.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 issues/8-llm-wiki/SPEC.md | 346 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 346 insertions(+)
 create mode 100644 issues/8-llm-wiki/SPEC.md

diff --git a/issues/8-llm-wiki/SPEC.md b/issues/8-llm-wiki/SPEC.md
new file mode 100644
index 0000000..780e7ac
--- /dev/null
+++ b/issues/8-llm-wiki/SPEC.md
@@ -0,0 +1,346 @@
+# Issue #8: llm-wiki 스킬 스펙
+
+> **스코프**: Karpathy LLM Wiki 패턴 + qmd 하이브리드 검색(Phase 2) + LanceDB 선택적 벡터 인덱스.
+> **출발점**: `wjtb-cmc`의 `llm-wiki` 스킬 포팅 + 일반화.
+> **이슈**: #8
+
+## 1. 개요
+
+### 1.1 목적
+
+프로젝트 문서(스펙/ADR/회의록/코드 설명 등)를 `wiki/raw/`에 모으고 LLM이 컴파일하여 `wiki/`에 교차참조된 마크다운 위키를 생성·유지한다. **검색이 아닌 컴파일**이 핵심 — 한 번 이해한 지식을 계속 다듬어 복리로 축적한다.
+
+### 1.2 핵심 가치
+
+- **복리 지식 축적**: RAG가 매번 재발견하는 반면, 위키는 한 번 정리한 지식을 계속 갱신
+- **Obsidian 호환**: `[[wiki-link]]` 형식, 그래프 뷰 가능
+- **qmd 하이브리드 검색**: BM25 + 벡터 + LLM 재순위 (설치 시 자동 활성)
+- **선택적 벡터 인덱스**: LanceDB + DuckDB + Embedding Atlas (대규모 위키 대응)
+- **Graceful degrade**: qmd 없어도 INDEX.md 라우팅으로 작동
+- **워크스페이스 컨벤션 정렬**: `wiki/` 노출형, 워크스페이스 CLAUDE.md의 "LLM Wiki 활용 규칙"과 일치
+
+---
+
+## 2. 아키텍처
+
+### 2.1 스킬 배치
+
+```text
+plugins/documentation/skills/llm-wiki/
+├── SKILL.md                              # 메인 지침 (~300줄)
+├── references/
+│   ├── page-templates.md                 # 6개 페이지 유형 템플릿 (포팅)
+│   ├── ingest-workflow.md                # 인제스트 5단계 상세 가이드 (포팅)
+│   ├── claude-md-block.md                # CLAUDE.md 추가 블록 템플릿 (포팅 + wiki/ 반영)
+│   ├── qmd-integration.md                # qmd 설치·컨텍스트·검색 옵션 (신규)
+│   ├── lancedb-integration.md            # LanceDB + Embedding Atlas 연결 (신규)
+│   └── karpathy-pattern.md               # 원본 패턴 + 본 구현 결정 기록 (신규)
+└── scripts/
+    ├── init.sh                           # wiki/ 구조 초기화 (포팅)
+    ├── sync_index.py                     # wiki/index.md 자동 재빌드 (포팅)
+    ├── lint_wiki.py                      # 끊어진 링크·고아·frontmatter 검증 (포팅)
+    ├── qmd_index.sh                      # qmd 인덱스 빌드/갱신 래퍼 (신규)
+    └── lancedb_sync.py                   # LanceDB 벡터 인덱스 동기화 (신규)
+```
+
+### 2.2 카테고리 및 등록
+
+- `plugins/documentation/` (기존)
+- `.claude-plugin/marketplace.json` documentation.skills 배열에 추가
+- `plugin.json` 그대로 유지 (버전 bump은 릴리스 시)
+
+### 2.3 디렉토리 컨벤션 (프로젝트 쪽)
+
+사용자 프로젝트 루트에 생성되는 구조:
+
+```text
+{user-project}/
+├── wiki/                                 # 노출형 (워크스페이스 CLAUDE.md 규칙)
+│   ├── index.md                          # 자동 재빌드 (sync_index.py)
+│   ├── log.md                            # ingest 이력
+│   ├── raw/                              # 원본 소스 드롭존 (불변)
+│   │   └── YYYY-MM-DD_{source}.md
+│   ├── {page}.md                         # 컴파일된 위키 페이지 (LLM 관리)
+│   └── .gitignore                        # raw/private/** 등
+├── CLAUDE.md                             # "LLM Wiki 활용 규칙" 블록 추가
+└── ...
+```
+
+---
+
+## 3. 명령어 세트 (8개)
+
+| 명령 | 역할 | 구현 위치 | qmd 필요? |
+|------|------|----------|-----------|
+| `init` | `wiki/` 구조 + `wiki/index.md` + `CLAUDE.md` 블록 생성 | `scripts/init.sh` | 아니오 |
+| `ingest <source>` | `raw/`에 드롭된 소스를 LLM이 컴파일, 10-15 페이지 갱신 | SKILL.md 워크플로 + `references/ingest-workflow.md` | 아니오 |
+| `query <질문>` | qmd 있음 → 하이브리드 검색 → LLM 합성 / qmd 없음 → INDEX.md 2-hop 라우팅 | SKILL.md 워크플로 | **선택(graceful)** |
+| `lint` | 끊어진 `[[link]]`, 고아 페이지, frontmatter 불완전 탐지 | `scripts/lint_wiki.py` | 아니오 |
+| `sync` | `wiki/index.md` 자동 재빌드 | `scripts/sync_index.py` | 아니오 |
+| `export <template>` | 온보딩/ADR 요약/릴리스 노트 등 템플릿 기반 출력 | SKILL.md 워크플로 | 아니오 |
+| `qmd-index` | qmd 인덱스 빌드/갱신 (`qmd index`) | `scripts/qmd_index.sh` | **예** |
+| `lancedb-sync` | 선택적 LanceDB 벡터 인덱스 동기화 | `scripts/lancedb_sync.py` | LanceDB |
+
+### 3.1 명령 설계 원칙
+
+- Phase 1 핵심 6개는 qmd 독립적으로 작동
+- Phase 2 확장 2개는 추가 의존성 명시적
+- `query`는 환경 감지로 자동 분기 (graceful degrade)
+- 모든 명령은 `argument-hint` frontmatter에 명시
+
+### 3.2 argument-hint
+
+```yaml
+argument-hint: [init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]
+```
+
+---
+
+## 4. Graceful Degrade 매트릭스
+
+| 환경 | `init` | `ingest` | `query` | `lint` | `sync` | `export` | `qmd-index` | `lancedb-sync` |
+|------|--------|----------|---------|--------|--------|----------|-------------|-----------------|
+| 최소 (bash+Python 표준) | ✅ | ✅ | ✅ (INDEX.md 라우팅) | ✅ | ✅ | ✅ | ⚠️ 설치 안내 | ⚠️ 설치 안내 |
+| qmd 설치됨 | ✅ | ✅ | ✅ (하이브리드) | ✅ | ✅ | ✅ | ✅ | ⚠️ 설치 안내 |
+| qmd + LanceDB 설치됨 | ✅ | ✅ | ✅ (하이브리드 + 벡터 가산) | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+### 4.1 감지 로직
+
+- `command -v qmd` → qmd 사용 가능 여부
+- `python3 -c "import lancedb"` → LanceDB 설치 여부
+- `init` 실행 시 감지 결과를 CLAUDE.md 블록에 기록하여 세션 간 재활용
+
+### 4.2 사용자 안내 메시지
+
+- qmd 없음 + `query`: **graceful degrade** — "qmd 미감지. INDEX.md 라우팅 모드로 계속 진행. 하이브리드 검색 원하면 `brew install qmd` 또는 `npm install -g @tobilu/qmd`." (exit 0, 계속 동작)
+- qmd 있음 + `qmd-index` 미실행 + `query`: "qmd 인덱스 없음. `/llm-wiki qmd-index` 먼저 실행 권장." (exit 0, INDEX.md fallback)
+- `qmd-index` 호출인데 qmd 없음: "qmd 미설치. 설치 후 재시도." (exit 1 — 명시적 명령이므로 실패 고지)
+- `lancedb-sync` 호출인데 LanceDB 없음: "`pip install lancedb duckdb` 실행 후 재시도." (exit 1 — 명시적 명령)
+
+**원칙**: `query`는 항상 작동하도록 degrade, 설치 전제 명시 명령(`qmd-index`, `lancedb-sync`)은 의존성 없으면 실패 고지.
+
+---
+
+## 5. references/ 내용
+
+### 5.1 page-templates.md (포팅)
+
+6개 페이지 유형: concept / decision / entity / meeting / policy / comparison
+각 템플릿에 frontmatter 예시 + 본문 구조.
+
+### 5.2 ingest-workflow.md (포팅)
+
+5단계 인제스트:
+1. 소스 읽기
+2. 엔티티/개념 추출
+3. 기존 wiki 페이지와 교차 참조 검토
+4. 페이지 생성/갱신
+5. log.md 기록
+
+### 5.3 claude-md-block.md (포팅 + 수정)
+
+사용자 프로젝트 CLAUDE.md에 추가되는 블록. `wiki/` 경로 사용 반영.
+
+### 5.4 qmd-integration.md (신규)
+
+- qmd 설치: `brew install qmd` (macOS), `npm install -g @tobilu/qmd` (기타)
+- 컨텍스트 트리 등록: `qmd context add qmd://wiki "<설명>"`
+- 검색 모드 3종: `search`(BM25), `vsearch`(벡터), `query`(하이브리드)
+- MCP 서버: Claude Code 네이티브 연동
+- 스마트 청킹 설정 권장값
+
+### 5.5 lancedb-integration.md (신규)
+
+- 설치: `pip install lancedb duckdb`
+- 임베딩 모델 선택 (기본 nomic-embed-text, 다국어 필요 시 Qwen3-Embedding)
+- `.lance` 파일 위치: `wiki/.lancedb/`
+- Embedding Atlas 연결: `pip install embedding-atlas` + `atlas open wiki/.lancedb/`
+- SQL 분석 쿼리 예시 ("지난 7일 미업데이트", "confidence low")
+
+### 5.6 karpathy-pattern.md (신규)
+
+- Karpathy 원본 gist 요약
+- 본 구현의 결정 기록:
+  - 왜 `wiki/`인가 (`.wiki/` 대신 — 워크스페이스 규칙 일치)
+  - 왜 qmd인가 (Karpathy 추천)
+  - LanceDB 선택적 이유 (Phase 3)
+- 복리 축적 vs RAG 대조 설명
+
+---
+
+## 6. scripts/ 상세
+
+### 6.1 init.sh
+
+- 작업: `wiki/`, `wiki/raw/`, `wiki/.gitignore` 생성 + `wiki/index.md`, `wiki/log.md` 초기 파일
+- `CLAUDE.md` 존재 확인, 없으면 `references/claude-md-block.md` 내용으로 생성, 있으면 블록 append
+- qmd/LanceDB 감지 결과 로깅
+
+### 6.2 sync_index.py
+
+- 입력: `wiki/*.md` 스캔
+- 출력: `wiki/index.md` 재빌드 (페이지 제목, 태그, 카테고리별 그룹)
+- 표준 라이브러리만 사용 (pyyaml은 번들 또는 대체 파싱)
+
+### 6.3 lint_wiki.py
+
+- 검사 항목:
+  - `[[wiki-link]]` 대상 존재 여부
+  - 고아 페이지 (INDEX.md에서 링크되지 않음)
+  - frontmatter 필수 필드 (`title`, `created`, `updated`, `status`)
+  - confidence 신뢰도 낮은 페이지 플래그
+- 출력: 표준출력 리포트 + exit code (0=green, 1=issues)
+
+### 6.4 qmd_index.sh (신규)
+
+- `qmd index wiki/` 호출
+- qmd 없으면 설치 안내 및 exit 0 (에러 아님 — graceful)
+
+### 6.5 lancedb_sync.py (신규)
+
+- `wiki/*.md` → 임베딩 생성 → LanceDB 테이블 갱신
+- `.lancedb/` 디렉토리에 저장
+- `lancedb`/`duckdb` 미설치 시 pip 명령 출력 + exit 1
+
+---
+
+## 7. 통합 포인트
+
+### 7.1 워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙"
+
+워크스페이스 CLAUDE.md는 이미 `wiki/` + `wiki/index.md` 존재를 LLM Wiki 사용 시그널로 규정함. 본 스킬이 이 규칙을 실제 실행 가능하게 함.
+
+SKILL.md description에 이 연동을 명시:
+> "워크스페이스 CLAUDE.md의 LLM Wiki 활용 규칙을 실행 가능하게 하는 스킬"
+
+### 7.2 `qa-merge` 스킬과의 파이프라인
+
+```
+qa (Q&A 카드 저장) → qa-list (목록) → qa-merge (통합 문서)
+                                          ↓
+                                        raw/ 드롭
+                                          ↓
+                                    llm-wiki ingest
+                                          ↓
+                                      wiki/*.md
+```
+
+SKILL.md에 "qa-merge 출력은 raw/의 유력 후보"로 명시.
+
+### 7.3 `intent` 스킬과의 연결
+
+`INTENT.md` → `raw/intent.md`로 복사 시 ingest 대상. Why/What/Not/Learnings 섹션이 위키의 entity/decision 페이지로 분해.
+
+### 7.4 `korean-docs` 스킬과의 직교성
+
+한국어 출력 규칙은 독립. 위키 내용은 한국어 가능, 페이지 식별자(제목, `[[link]]`)는 영어 식별자 허용 (Obsidian 호환).
+
+---
+
+## 8. Obsidian 호환
+
+### 8.1 링크 형식
+
+- `[[page-name]]` — Obsidian 네이티브
+- `[[page-name|display text]]` — 별칭 링크
+
+### 8.2 그래프 뷰
+
+사용자는 Obsidian으로 `wiki/` vault를 열어 교차 참조 시각화 가능. 본 스킬이 생성하는 마크다운이 Obsidian 호환 표준.
+
+### 8.3 제약
+
+- frontmatter 날짜는 ISO 8601 (`YYYY-MM-DD`)
+- 코드 블록은 펜스 fenced (` ``` `)
+- 수식은 LaTeX 인라인 `$...$` 또는 블록 `$$...$$`
+
+---
+
+## 9. 검증 사례 및 인용 규칙
+
+### 9.1 외부 레퍼런스
+
+- Karpathy LLM Wiki gist: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
+- qmd: https://github.com/tobi/qmd
+- LanceDB: https://lancedb.com
+- Apple Embedding Atlas: https://github.com/apple/embedding-atlas
+- Anthropic Contextual Retrieval: https://anthropic.com/news/contextual-retrieval
+
+### 9.2 내부 레퍼런스
+
+- 포팅 원본: `wjtb-cmc/.claude/skills/llm-wiki/` (로컬, commit 고정 필요)
+- 리서치 리포트: `~/Downloads/llm-wiki-qmd-vectordb-complete-report.md`
+
+### 9.3 인용 라벨
+
+- `[Karpathy]` — Karpathy gist 원문
+- `[qmd]` — qmd 공식 문서
+- `[LanceDB]` — LanceDB 공식
+- `[Port: wjtb-cmc]` — 포팅 출처 표시
+
+---
+
+## 10. Non-Goals
+
+- **RAG 벡터 검색 전용**: Karpathy 원칙 준수, RAG보다 컴파일 우선
+- **멀티 프로젝트 통합 위키**: 단일 프로젝트 위키만. 멀티는 향후
+- **Web UI**: Obsidian 또는 기존 마크다운 뷰어로 대체
+- **실시간 파일 워처**: `sync`/`lint` 수동 호출 방식
+- **LLM 모델 번들**: qmd/LanceDB 모델은 외부 의존
+- **LEP·wjtb-cmc 특수 로직 유지**: 포팅 시 전부 일반화
+
+---
+
+## 11. 성공 기준
+
+### 11.1 기능
+
+- [ ] `init`으로 새 프로젝트에 `wiki/` 구조 생성 성공
+- [ ] 샘플 소스(라이트페이퍼 1개) `ingest` 실행 시 5-10 페이지 생성, `[[link]]` 교차참조 정상
+- [ ] `lint` 실행 시 끊어진 링크·고아 페이지 탐지
+- [ ] `sync` 실행 시 `index.md` 재빌드
+- [ ] qmd 설치 환경에서 `query` 하이브리드 검색 동작
+- [ ] qmd 미설치 환경에서 `query` INDEX.md 라우팅으로 fallback
+- [ ] LanceDB 설치 환경에서 `lancedb-sync` 성공 + Embedding Atlas 연결 가능
+
+### 11.2 통합
+
+- [ ] `npm test` 197+ tests green (마켓플레이스 등록 후 증가분 포함)
+- [ ] `plugins/documentation/README.md`에 llm-wiki 행 추가
+- [ ] root `README.md`에 llm-wiki 등록
+- [ ] CHANGELOG `[Unreleased]` 엔트리
+
+### 11.3 워크스페이스 규칙 반영
+
+- [ ] 워크스페이스 CLAUDE.md의 "LLM Wiki 활용 규칙"이 본 스킬을 통해 실행 가능
+
+---
+
+## 12. 인터뷰 요약 (설계 결정 기록)
+
+| 항목 | 결정 |
+|------|------|
+| 스코프 | Phase 2 — qmd 필수 + LanceDB 선택 |
+| 스킬 구조 | 단일 스킬 (8개 서브커맨드) |
+| 디렉토리 | `wiki/` 노출형 (워크스페이스 CLAUDE.md 규칙 일치) |
+| 카테고리 | `documentation/` |
+| qmd fallback | Graceful degrade → INDEX.md 라우팅 |
+| 출발점 | `wjtb-cmc` 스킬 포팅 + 일반화 |
+| 언어 | bash + Python 표준 라이브러리 중심 |
+| Obsidian 호환 | `[[wiki-link]]` 표준 |
+| qa-merge 파이프라인 | `raw/` 드롭 지점으로 명시 |
+
+---
+
+## 13. Open Questions (구현 단계에서 결정)
+
+- **scripts의 Python 버전**: 3.8+ vs 3.10+ — wjtb-cmc 기존 기준 따름, 확인 필요
+- **frontmatter 파싱**: pyyaml 의존 vs 표준 라이브러리 수동 파싱 — 후자 권장 (zero-dep)
+- **Embedding Atlas 버전**: 2026 시점 MIT 버전 기준, 주기적 재확인
+- **qmd 브루 탭**: 공식 brew tap 여부 재확인, 없으면 npm 경로 우선
+- **LanceDB 스키마**: 임베딩 차원, 메타데이터 컬럼 명세 — 구현 시 결정
+
+---
+
+*설계 기준 일자: 2026-04-19.*
+*근거: `~/Downloads/LLM_WIKI_HANDOFF.md`, `~/Downloads/llm-wiki-qmd-vectordb-complete-report.md`, 워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙".*

From 5f935e5a887c18d2815ac875d2d83ee3359b5be1 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:36:01 +0900
Subject: [PATCH 02/21] docs(issues/8): add TASKS bite-sized implementation
 plan (#8)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Stage A (PLAN overview) → B (scaffold) → C (scripts) → D (references) →
E (SKILL.md) → F (integration) → G (verification). 7 stages, 19 tasks.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 issues/8-llm-wiki/TASKS.md | 1751 ++++++++++++++++++++++++++++++++++++
 1 file changed, 1751 insertions(+)
 create mode 100644 issues/8-llm-wiki/TASKS.md

diff --git a/issues/8-llm-wiki/TASKS.md b/issues/8-llm-wiki/TASKS.md
new file mode 100644
index 0000000..0973d22
--- /dev/null
+++ b/issues/8-llm-wiki/TASKS.md
@@ -0,0 +1,1751 @@
+# llm-wiki Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Ship `plugins/documentation/skills/llm-wiki/` — a Karpathy LLM Wiki skill with `init/ingest/query/lint/sync/export/qmd-index/lancedb-sync` commands, graceful qmd fallback, and optional LanceDB vector indexing.
+
+**Architecture:** Port + generalize the existing `wjtb-cmc/.claude/skills/llm-wiki/` skill. Convert `.wiki/` → `wiki/` visible directory to match workspace CLAUDE.md convention. Add qmd/LanceDB integration layers. 6 reference docs + 5 scripts + SKILL.md (≤300 lines).
+
+**Tech Stack:** Markdown (SKILL + references), YAML frontmatter, bash + Python 3.8+ (stdlib + optional `lancedb`/`duckdb`), external CLIs (`qmd`), existing Vitest harness.
+
+---
+
+## File Structure
+
+```
+plugins/documentation/skills/llm-wiki/              # CREATE
+├── SKILL.md                                        # ≤300 lines, 8-command orchestrator
+├── references/                                     # CREATE
+│   ├── page-templates.md                           # PORT from wjtb-cmc (223 lines)
+│   ├── ingest-workflow.md                          # PORT from wjtb-cmc (121 lines)
+│   ├── claude-md-block.md                          # PORT + adapt wiki/ path (wjtb-cmc 33 lines)
+│   ├── qmd-integration.md                          # NEW
+│   ├── lancedb-integration.md                      # NEW
+│   └── karpathy-pattern.md                         # NEW
+└── scripts/                                        # CREATE
+    ├── init.sh                                     # PORT + generalize (wjtb-cmc 79 lines)
+    ├── sync_index.py                               # PORT + generalize (wjtb-cmc 132 lines)
+    ├── lint_wiki.py                                # PORT + generalize (wjtb-cmc 138 lines)
+    ├── qmd_index.sh                                # NEW
+    └── lancedb_sync.py                             # NEW
+
+.claude-plugin/marketplace.json                     # MODIFY — add skill path
+plugins/documentation/README.md                     # MODIFY — add row + bullet + example
+README.md                                           # MODIFY — root Documentation section
+CHANGELOG.md                                        # MODIFY — Unreleased entry
+
+issues/8-llm-wiki/PLAN.md                           # CREATE — stage overview (companion to this file)
+```
+
+**Source of truth for port:** `/Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/`
+
+**Test command:** `npm test` (197+ tests expected green after skill registered)
+
+---
+
+## Stage A — Research & Write PLAN.md
+
+### Task A1: Write PLAN.md stage overview
+
+**Files:**
+- Create: `issues/8-llm-wiki/PLAN.md`
+
+- [ ] **Step 1: Write PLAN.md**
+
+Content template (adapt from `issues/3-serverless-migration/PLAN.md` structure):
+
+```markdown
+# Issue #8: llm-wiki 구현 계획
+
+> **전제**: `SPEC.md` 승인 후 착수 (완료: 2026-04-19).
+> **구현 위치**: `plugins/documentation/skills/llm-wiki/`.
+> **총 예상 공수**: ~1.5일(1인). 포팅 0.5일 + 신규 references+scripts 0.5일 + SKILL.md+통합 0.5일.
+
+## 0. 선행 조건
+- [x] HANDOFF.md 읽음 (~/Downloads/LLM_WIKI_HANDOFF.md)
+- [x] Research report 읽음 (~/Downloads/llm-wiki-qmd-vectordb-complete-report.md)
+- [x] SPEC.md 작성
+- [ ] SPEC.md 사용자 승인 — Stage B 시작 전 필수
+- [x] 포팅 원본 접근 확인 (wjtb-cmc/.claude/skills/llm-wiki/)
+
+## 1. 구현 단계
+
+### Stage B — 스킬 스캐폴드 (~0.2일)
+...
+
+### Stage C — 스크립트 포팅 + 신규 (~0.5일)
+...
+
+### Stage D — references 포팅 + 신규 (~0.5일)
+...
+
+### Stage E — SKILL.md 본문 (~0.2일)
+...
+
+### Stage F — 통합 (~0.1일)
+...
+
+## 2. 리스크 및 완화
+| 리스크 | 영향 | 완화 |
+|-------|------|------|
+| wjtb-cmc 스킬에 LEP 특수 로직이 숨어있음 | 일반화 누락 시 다른 프로젝트에서 오동작 | 포팅 시 grep으로 "LEP" 전부 제거 후 테스트 |
+| qmd CLI 옵션이 2026-04 기준과 달라짐 | qmd_index.sh 동작 실패 | 스크립트 상단에 버전 주석, qmd 미설치 graceful |
+| Python 표준 YAML 부재 | sync_index/lint_wiki 파싱 실패 | 수동 frontmatter 파싱 구현 (zero-dep) |
+
+## 3. 수락 기준
+- [ ] SPEC §11 기능 체크리스트 전부 통과
+- [ ] `npm test` green
+- [ ] SKILL.md ≤300 lines
+- [ ] Tier별 시나리오 3개 read-through 통과
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add issues/8-llm-wiki/PLAN.md
+git commit -m "docs(issues/8): add PLAN for llm-wiki stage overview (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+---
+
+## Stage B — Scaffold skill directory
+
+### Task B1: Create skill + empty stubs
+
+**Files:**
+- Create: `plugins/documentation/skills/llm-wiki/SKILL.md`
+- Create: `plugins/documentation/skills/llm-wiki/references/` (6 stub files)
+- Create: `plugins/documentation/skills/llm-wiki/scripts/` (5 stub files)
+
+- [ ] **Step 1: Create SKILL.md stub**
+
+Write to `plugins/documentation/skills/llm-wiki/SKILL.md`:
+
+```markdown
+---
+name: llm-wiki
+description: Karpathy LLM Wiki 패턴 구현. 프로젝트 문서(스펙/ADR/회의록)를 wiki/raw/에 모으고 LLM이 컴파일하여 wiki/에 교차참조 마크다운 위키를 생성·갱신. qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB 선택적 벡터 인덱스. Obsidian 호환. 하위 명령 - init, ingest, query, lint, sync, export, qmd-index, lancedb-sync.
+argument-hint: [init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]
+---
+
+# llm-wiki
+
+스캐폴드 상태 — 본문은 Stage E에서 작성.
+```
+
+- [ ] **Step 2: Create 6 reference stubs**
+
+For each filename, create the file with content:
+
+```markdown
+> **Snapshot date**: 2026-04-19
+> **Description**: {description}
+
+TBD — Stage D에서 작성.
+```
+
+Filenames + descriptions:
+
+| File | Description |
+|------|-------------|
+| `page-templates.md` | 위키 페이지 6개 유형 템플릿 (concept/decision/entity/meeting/policy/comparison) |
+| `ingest-workflow.md` | Ingest 5단계 상세 가이드 |
+| `claude-md-block.md` | 사용자 프로젝트 CLAUDE.md에 추가할 LLM Wiki 참조 블록 |
+| `qmd-integration.md` | qmd 설치·컨텍스트 등록·하이브리드 검색 옵션 |
+| `lancedb-integration.md` | LanceDB 벡터 인덱스 + Embedding Atlas 연결 |
+| `karpathy-pattern.md` | Karpathy 원본 패턴 요약 및 본 구현 결정 기록 |
+
+- [ ] **Step 3: Create 5 script stubs**
+
+```bash
+# init.sh
+cat > plugins/documentation/skills/llm-wiki/scripts/init.sh <<'SH'
+#!/usr/bin/env bash
+# llm-wiki init — Stage C에서 구현.
+exit 1
+SH
+chmod +x plugins/documentation/skills/llm-wiki/scripts/init.sh
+
+# sync_index.py
+cat > plugins/documentation/skills/llm-wiki/scripts/sync_index.py <<'PY'
+#!/usr/bin/env python3
+"""llm-wiki sync_index — Stage C에서 구현."""
+raise SystemExit(1)
+PY
+chmod +x plugins/documentation/skills/llm-wiki/scripts/sync_index.py
+
+# lint_wiki.py
+cat > plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py <<'PY'
+#!/usr/bin/env python3
+"""llm-wiki lint — Stage C에서 구현."""
+raise SystemExit(1)
+PY
+chmod +x plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
+
+# qmd_index.sh
+cat > plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh <<'SH'
+#!/usr/bin/env bash
+# llm-wiki qmd-index — Stage C에서 구현.
+exit 1
+SH
+chmod +x plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
+
+# lancedb_sync.py
+cat > plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py <<'PY'
+#!/usr/bin/env python3
+"""llm-wiki lancedb-sync — Stage C에서 구현."""
+raise SystemExit(1)
+PY
+chmod +x plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
+```
+
+- [ ] **Step 4: Verify directory shape**
+
+Run:
+```bash
+ls plugins/documentation/skills/llm-wiki/
+ls plugins/documentation/skills/llm-wiki/references/ | wc -l
+ls plugins/documentation/skills/llm-wiki/scripts/ | wc -l
+```
+Expect: SKILL.md + references + scripts dirs; `6` references; `5` scripts.
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/
+git commit -m "scaffold(llm-wiki): create skill + 6 reference stubs + 5 script stubs (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task B2: Register in marketplace.json
+
+**Files:**
+- Modify: `.claude-plugin/marketplace.json`
+
+- [ ] **Step 1: Add skill path to documentation.skills**
+
+Current documentation.skills:
+```json
+"skills": [
+  "./skills/korean-docs/SKILL.md",
+  "./skills/qa/SKILL.md",
+  "./skills/qa-list/SKILL.md",
+  "./skills/qa-merge/SKILL.md"
+]
+```
+
+Append `"./skills/llm-wiki/SKILL.md"` at end (insertion order convention).
+
+- [ ] **Step 2: Run tests**
+
+```bash
+npm test
+```
+Expected: green. If `skills.test.ts` or `integrity.test.ts` fails, fix the SKILL.md frontmatter or path.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add .claude-plugin/marketplace.json
+git commit -m "scaffold(llm-wiki): register in marketplace (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+---
+
+## Stage C — Port + generalize scripts
+
+### Task C1: Port init.sh
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/scripts/init.sh`
+- Source: `/Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/init.sh` (79 lines)
+
+- [ ] **Step 1: Read source**
+
+```bash
+cat /Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/init.sh
+```
+
+- [ ] **Step 2: Write adapted script**
+
+Write to `plugins/documentation/skills/llm-wiki/scripts/init.sh`:
+
+```bash
+#!/usr/bin/env bash
+# llm-wiki init — 프로젝트 루트에 wiki/ 구조 초기화.
+# Usage: ./init.sh [project-root]
+set -euo pipefail
+
+PROJECT_ROOT="${1:-$PWD}"
+WIKI_DIR="$PROJECT_ROOT/wiki"
+RAW_DIR="$WIKI_DIR/raw"
+CLAUDE_MD="$PROJECT_ROOT/CLAUDE.md"
+SKILL_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+CLAUDE_BLOCK_TPL="$SKILL_DIR/references/claude-md-block.md"
+
+echo "→ llm-wiki init at: $PROJECT_ROOT"
+
+# 1. 디렉토리 구조 생성
+mkdir -p "$WIKI_DIR" "$RAW_DIR"
+
+# 2. 초기 파일 생성 (존재하면 건너뜀)
+if [ ! -f "$WIKI_DIR/index.md" ]; then
+  cat > "$WIKI_DIR/index.md" <<EOF
+# Wiki Index
+
+> 이 파일은 \`sync_index.py\`로 자동 재빌드됩니다. 수동 편집하지 마세요.
+
+## 페이지 목록
+
+(sync 실행 전)
+EOF
+  echo "  ✓ wiki/index.md"
+fi
+
+if [ ! -f "$WIKI_DIR/log.md" ]; then
+  cat > "$WIKI_DIR/log.md" <<EOF
+# Wiki Log
+
+Ingest 이력 타임라인. 최신 항목이 위.
+
+EOF
+  echo "  ✓ wiki/log.md"
+fi
+
+if [ ! -f "$WIKI_DIR/.gitignore" ]; then
+  cat > "$WIKI_DIR/.gitignore" <<EOF
+# llm-wiki defaults
+raw/private/
+.lancedb/
+EOF
+  echo "  ✓ wiki/.gitignore"
+fi
+
+# 3. CLAUDE.md에 LLM Wiki 블록 추가 (없으면 추가, 있으면 건너뜀)
+if [ -f "$CLAUDE_MD" ]; then
+  if ! grep -q "LLM Wiki 활용 규칙" "$CLAUDE_MD" 2>/dev/null; then
+    echo "" >> "$CLAUDE_MD"
+    cat "$CLAUDE_BLOCK_TPL" >> "$CLAUDE_MD"
+    echo "  ✓ CLAUDE.md에 LLM Wiki 블록 추가"
+  else
+    echo "  = CLAUDE.md 이미 LLM Wiki 블록 존재 — 건너뜀"
+  fi
+else
+  cat "$CLAUDE_BLOCK_TPL" > "$CLAUDE_MD"
+  echo "  ✓ CLAUDE.md 생성"
+fi
+
+# 4. qmd / lancedb 감지
+echo ""
+echo "→ 환경 감지:"
+if command -v qmd >/dev/null 2>&1; then
+  echo "  ✓ qmd 감지 — 하이브리드 검색 활성 가능. 'qmd-index' 명령 실행 권장."
+else
+  echo "  ⚠ qmd 미감지 — INDEX.md 라우팅 모드로 동작. 하이브리드 검색 원하면:"
+  echo "    brew install qmd   # macOS"
+  echo "    npm install -g @tobilu/qmd   # 기타"
+fi
+
+if python3 -c "import lancedb" >/dev/null 2>&1; then
+  echo "  ✓ LanceDB 감지 — 벡터 인덱스 활성 가능. 'lancedb-sync' 명령 실행 권장."
+else
+  echo "  ⚠ LanceDB 미감지 (선택). 원하면: pip install lancedb duckdb"
+fi
+
+echo ""
+echo "✓ llm-wiki init 완료."
+```
+
+- [ ] **Step 3: Sanity test**
+
+```bash
+cd /tmp && rm -rf llm-wiki-test && mkdir llm-wiki-test && cd llm-wiki-test
+/Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/init.sh
+```
+Expected: creates `wiki/raw/`, `wiki/index.md`, `wiki/log.md`, `wiki/.gitignore`, `CLAUDE.md`. Prints qmd/LanceDB detection.
+
+Cleanup: `cd && rm -rf /tmp/llm-wiki-test`
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/scripts/init.sh
+git commit -m "feat(llm-wiki): port init.sh with wiki/ convention and env detection (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task C2: Port sync_index.py
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/scripts/sync_index.py`
+- Source: `/Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/sync_index.py` (132 lines)
+
+- [ ] **Step 1: Read source and identify LEP-specific portions**
+
+```bash
+cat /Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/sync_index.py
+grep -n "LEP\|lep" /Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/sync_index.py
+```
+
+- [ ] **Step 2: Adapt and write**
+
+Port the source with these generalizations:
+- Change default wiki path from `.wiki/` to `wiki/`
+- Remove LEP/project-specific hardcoded category names
+- Preserve: frontmatter parsing logic, page grouping, tag extraction
+- CLI flag: `--wiki-dir` (default `./wiki`)
+- zero-dep: use stdlib only (no pyyaml)
+
+Minimum viable interface (adapt content from source to match):
+
+```python
+#!/usr/bin/env python3
+"""Rebuild wiki/index.md by scanning wiki/*.md for frontmatter and links.
+
+Usage:
+    ./sync_index.py [--wiki-dir PATH]
+
+Default --wiki-dir is ./wiki relative to CWD.
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+from collections import defaultdict
+
+FRONTMATTER_RE = re.compile(r'\A---\n(.*?)\n---\n', re.DOTALL)
+
+def parse_frontmatter(text):
+    """Simple zero-dep YAML-ish frontmatter parser.
+
+    Supports: key: value, key: [a, b, c] (inline list), key: "quoted value"
+    Does not support: nested dicts, block lists, multi-line scalars.
+    """
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    fm_text = m.group(1)
+    result = {}
+    for line in fm_text.splitlines():
+        if not line.strip() or line.strip().startswith('#'):
+            continue
+        if ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        k = k.strip()
+        v = v.strip()
+        if v.startswith('[') and v.endswith(']'):
+            v = [x.strip().strip('"\'') for x in v[1:-1].split(',') if x.strip()]
+        elif (v.startswith('"') and v.endswith('"')) or (v.startswith("'") and v.endswith("'")):
+            v = v[1:-1]
+        result[k] = v
+    return result
+
+def collect_pages(wiki_dir):
+    """Scan wiki_dir for *.md (excluding index.md, log.md, raw/)."""
+    pages = []
+    for md in wiki_dir.rglob('*.md'):
+        if md.name in ('index.md', 'log.md'):
+            continue
+        if 'raw' in md.relative_to(wiki_dir).parts:
+            continue
+        text = md.read_text(encoding='utf-8')
+        fm = parse_frontmatter(text)
+        pages.append({
+            'path': md.relative_to(wiki_dir),
+            'title': fm.get('title', md.stem),
+            'type': fm.get('type', 'page'),
+            'tags': fm.get('tags', []) if isinstance(fm.get('tags'), list) else [fm.get('tags')] if fm.get('tags') else [],
+            'status': fm.get('status', ''),
+            'updated': fm.get('updated', ''),
+        })
+    return pages
+
+def render_index(pages):
+    """Render index.md content grouped by type."""
+    lines = [
+        '# Wiki Index',
+        '',
+        '> 이 파일은 `sync_index.py`로 자동 재빌드됩니다. 수동 편집하지 마세요.',
+        f'> 총 {len(pages)}개 페이지.',
+        '',
+    ]
+    groups = defaultdict(list)
+    for p in pages:
+        groups[p['type']].append(p)
+    for type_name in sorted(groups.keys()):
+        lines.append(f'## {type_name.capitalize()} ({len(groups[type_name])})')
+        lines.append('')
+        for p in sorted(groups[type_name], key=lambda x: str(x['path'])):
+            tags_str = f" — tags: {', '.join(p['tags'])}" if p['tags'] else ''
+            status_str = f" [{p['status']}]" if p['status'] else ''
+            lines.append(f"- [[{p['path'].stem}|{p['title']}]]{status_str}{tags_str}")
+        lines.append('')
+    return '\n'.join(lines)
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__.split('\n')[0])
+    parser.add_argument('--wiki-dir', default='./wiki', help='wiki directory (default ./wiki)')
+    args = parser.parse_args()
+
+    wiki_dir = Path(args.wiki_dir).resolve()
+    if not wiki_dir.is_dir():
+        print(f"error: wiki directory not found: {wiki_dir}", file=sys.stderr)
+        return 1
+
+    pages = collect_pages(wiki_dir)
+    index_content = render_index(pages)
+    index_path = wiki_dir / 'index.md'
+    index_path.write_text(index_content, encoding='utf-8')
+    print(f"✓ {index_path} 재빌드 완료 ({len(pages)} 페이지)")
+    return 0
+
+if __name__ == '__main__':
+    sys.exit(main())
+```
+
+- [ ] **Step 3: Sanity test**
+
+```bash
+cd /tmp && rm -rf llm-wiki-test && mkdir llm-wiki-test && cd llm-wiki-test
+/Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/init.sh
+cat > wiki/alpha.md <<'EOF'
+---
+title: Alpha
+type: concept
+tags: [test]
+status: draft
+updated: 2026-04-19
+---
+# Alpha
+Body
+EOF
+cat > wiki/beta.md <<'EOF'
+---
+title: Beta
+type: decision
+updated: 2026-04-19
+---
+# Beta
+EOF
+python3 /Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/sync_index.py --wiki-dir ./wiki
+cat wiki/index.md
+```
+Expected: `## Concept (1)` with Alpha, `## Decision (1)` with Beta.
+
+Cleanup: `cd && rm -rf /tmp/llm-wiki-test`
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/scripts/sync_index.py
+git commit -m "feat(llm-wiki): port sync_index.py with zero-dep frontmatter parsing (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task C3: Port lint_wiki.py
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py`
+- Source: `/Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/lint_wiki.py` (138 lines)
+
+- [ ] **Step 1: Read source**
+
+```bash
+cat /Users/dohyunjung/Workspace/wjtb/wjtb-cmc/.claude/skills/llm-wiki/scripts/lint_wiki.py
+```
+
+- [ ] **Step 2: Adapt**
+
+Port with:
+- Default `--wiki-dir ./wiki`
+- Check: broken `[[links]]`, orphan pages (not linked from index.md), frontmatter required fields (`title`, `updated`), confidence flag
+- Return exit code 0 (green) or 1 (issues found)
+
+Minimum viable structure:
+
+```python
+#!/usr/bin/env python3
+"""Lint wiki/*.md for broken links, orphans, and missing frontmatter.
+
+Usage:
+    ./lint_wiki.py [--wiki-dir PATH]
+
+Exit code 0 if clean, 1 if issues.
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+
+WIKILINK_RE = re.compile(r'\[\[([^\]|]+)(?:\|[^\]]+)?\]\]')
+FRONTMATTER_RE = re.compile(r'\A---\n(.*?)\n---\n', re.DOTALL)
+REQUIRED_FM = ['title', 'updated']
+
+def parse_frontmatter(text):
+    """Same parser as sync_index.py — kept inline for zero-dep."""
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    result = {}
+    for line in m.group(1).splitlines():
+        if not line.strip() or line.strip().startswith('#') or ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        result[k.strip()] = v.strip()
+    return result
+
+def lint(wiki_dir):
+    md_files = [p for p in wiki_dir.rglob('*.md') if 'raw' not in p.relative_to(wiki_dir).parts]
+    page_stems = {p.stem for p in md_files if p.name not in ('index.md', 'log.md')}
+
+    issues = []
+    referenced = set()
+
+    for md in md_files:
+        if md.name in ('index.md', 'log.md'):
+            text = md.read_text(encoding='utf-8')
+            for link in WIKILINK_RE.findall(text):
+                referenced.add(link.strip())
+            continue
+
+        text = md.read_text(encoding='utf-8')
+        fm = parse_frontmatter(text)
+
+        for field in REQUIRED_FM:
+            if field not in fm or not fm[field]:
+                issues.append(f"{md.relative_to(wiki_dir)}: frontmatter `{field}` missing")
+
+        confidence = fm.get('confidence', '').lower()
+        if confidence in ('low', 'tentative'):
+            issues.append(f"{md.relative_to(wiki_dir)}: low-confidence page flagged")
+
+        for link in WIKILINK_RE.findall(text):
+            target = link.strip()
+            referenced.add(target)
+            if target not in page_stems:
+                issues.append(f"{md.relative_to(wiki_dir)}: broken link [[{target}]]")
+
+    orphans = page_stems - referenced
+    for orphan in sorted(orphans):
+        issues.append(f"wiki/{orphan}.md: orphan (not referenced from any page)")
+
+    return issues
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__.split('\n')[0])
+    parser.add_argument('--wiki-dir', default='./wiki')
+    args = parser.parse_args()
+
+    wiki_dir = Path(args.wiki_dir).resolve()
+    if not wiki_dir.is_dir():
+        print(f"error: wiki directory not found: {wiki_dir}", file=sys.stderr)
+        return 1
+
+    issues = lint(wiki_dir)
+    if not issues:
+        print(f"✓ clean ({sum(1 for _ in wiki_dir.rglob('*.md'))} files)")
+        return 0
+
+    print(f"⚠ {len(issues)} issue(s):", file=sys.stderr)
+    for issue in issues:
+        print(f"  - {issue}", file=sys.stderr)
+    return 1
+
+if __name__ == '__main__':
+    sys.exit(main())
+```
+
+- [ ] **Step 3: Sanity test with orphan**
+
+```bash
+cd /tmp && rm -rf llm-wiki-test && mkdir llm-wiki-test && cd llm-wiki-test
+mkdir -p wiki/raw
+cat > wiki/index.md <<'EOF'
+# Wiki Index
+- [[alpha]]
+EOF
+cat > wiki/alpha.md <<'EOF'
+---
+title: Alpha
+updated: 2026-04-19
+---
+# Alpha
+See [[beta]] for details.
+EOF
+cat > wiki/orphan.md <<'EOF'
+---
+title: Orphan
+updated: 2026-04-19
+---
+# Orphan
+EOF
+python3 /Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py --wiki-dir ./wiki
+```
+Expected: exit 1 with issues listing broken link `[[beta]]` and orphan `orphan.md`.
+
+Cleanup: `cd && rm -rf /tmp/llm-wiki-test`
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
+git commit -m "feat(llm-wiki): port lint_wiki.py with link/orphan/frontmatter checks (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task C4: New qmd_index.sh
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh`
+
+- [ ] **Step 1: Write script**
+
+```bash
+#!/usr/bin/env bash
+# llm-wiki qmd-index — qmd 인덱스 빌드/갱신.
+# Usage: ./qmd_index.sh [wiki-dir]
+set -euo pipefail
+
+WIKI_DIR="${1:-./wiki}"
+
+if [ ! -d "$WIKI_DIR" ]; then
+  echo "error: wiki directory not found: $WIKI_DIR" >&2
+  exit 1
+fi
+
+if ! command -v qmd >/dev/null 2>&1; then
+  echo "error: qmd 미설치. 설치 후 재시도:" >&2
+  echo "  brew install qmd          # macOS" >&2
+  echo "  npm install -g @tobilu/qmd  # 기타" >&2
+  exit 1
+fi
+
+echo "→ qmd index $WIKI_DIR"
+qmd index "$WIKI_DIR"
+
+# 컨텍스트 등록 (이미 있으면 qmd 쪽에서 idempotent)
+qmd context add "qmd://$(basename "$(cd "$WIKI_DIR" && pwd)")" \
+  "LLM Wiki: 프로젝트 컨텍스트 위키 (Karpathy 패턴)" || true
+
+echo "✓ qmd-index 완료. 검색: qmd query \"<질문>\""
+```
+
+- [ ] **Step 2: Sanity test (skip if qmd not installed)**
+
+```bash
+if command -v qmd >/dev/null 2>&1; then
+  cd /tmp && rm -rf llm-wiki-test && mkdir llm-wiki-test && cd llm-wiki-test
+  /Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/init.sh
+  echo "# Test" > wiki/test.md
+  /Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
+  cd && rm -rf /tmp/llm-wiki-test
+else
+  echo "qmd not installed — skip sanity test, will validate via graceful degrade instead"
+fi
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
+git commit -m "feat(llm-wiki): add qmd_index.sh wrapper with install guidance (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task C5: New lancedb_sync.py
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py`
+
+- [ ] **Step 1: Write script**
+
+```python
+#!/usr/bin/env python3
+"""Sync wiki/*.md into a LanceDB vector index at wiki/.lancedb/.
+
+Requires: pip install lancedb duckdb sentence-transformers
+
+Usage:
+    ./lancedb_sync.py [--wiki-dir PATH] [--model MODEL] [--table TABLE]
+
+Graceful failure: exits 1 with pip install guidance if deps missing.
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+
+FRONTMATTER_RE = re.compile(r'\A---\n(.*?)\n---\n', re.DOTALL)
+
+def parse_frontmatter(text):
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    result = {}
+    for line in m.group(1).splitlines():
+        if not line.strip() or line.strip().startswith('#') or ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        result[k.strip()] = v.strip()
+    return result
+
+def strip_frontmatter(text):
+    m = FRONTMATTER_RE.match(text)
+    return text[m.end():] if m else text
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__.split('\n')[0])
+    parser.add_argument('--wiki-dir', default='./wiki')
+    parser.add_argument('--model', default='all-MiniLM-L6-v2',
+                        help='sentence-transformers model name')
+    parser.add_argument('--table', default='wiki_pages')
+    args = parser.parse_args()
+
+    try:
+        import lancedb
+        from sentence_transformers import SentenceTransformer
+    except ImportError as e:
+        print(f"error: 필수 의존성 누락 ({e.name}). 설치:", file=sys.stderr)
+        print("  pip install lancedb duckdb sentence-transformers", file=sys.stderr)
+        return 1
+
+    wiki_dir = Path(args.wiki_dir).resolve()
+    if not wiki_dir.is_dir():
+        print(f"error: wiki directory not found: {wiki_dir}", file=sys.stderr)
+        return 1
+
+    db_dir = wiki_dir / '.lancedb'
+    db_dir.mkdir(exist_ok=True)
+
+    print(f"→ 임베딩 모델 로드: {args.model}")
+    model = SentenceTransformer(args.model)
+
+    records = []
+    for md in wiki_dir.rglob('*.md'):
+        if md.name in ('index.md', 'log.md'):
+            continue
+        if 'raw' in md.relative_to(wiki_dir).parts:
+            continue
+        text = md.read_text(encoding='utf-8')
+        fm = parse_frontmatter(text)
+        body = strip_frontmatter(text)
+        if not body.strip():
+            continue
+        vec = model.encode(body).tolist()
+        records.append({
+            'path': str(md.relative_to(wiki_dir)),
+            'title': fm.get('title', md.stem),
+            'type': fm.get('type', 'page'),
+            'vector': vec,
+            'text': body[:10000],  # store preview only
+        })
+
+    if not records:
+        print("⚠ 인덱싱할 페이지가 없음.")
+        return 0
+
+    print(f"→ LanceDB 테이블 '{args.table}' 갱신 ({len(records)} 페이지)")
+    db = lancedb.connect(str(db_dir))
+    if args.table in db.table_names():
+        db.drop_table(args.table)
+    db.create_table(args.table, data=records)
+
+    print(f"✓ lancedb-sync 완료. Embedding Atlas: atlas open {db_dir}")
+    return 0
+
+if __name__ == '__main__':
+    sys.exit(main())
+```
+
+- [ ] **Step 2: Sanity test (dry-run without deps)**
+
+```bash
+python3 /Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py --wiki-dir /tmp/nonexistent
+```
+Expected: exit 1 with `pip install lancedb...` message (if deps missing) OR wiki not found error.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
+git commit -m "feat(llm-wiki): add lancedb_sync.py with graceful dep fallback (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+---
+
+## Stage D — Author references
+
+### Task D1: Port page-templates.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/references/page-templates.md`
+- Source: `wjtb-cmc/.claude/skills/llm-wiki/references/page-templates.md` (223 lines)
+
+- [ ] **Step 1: Read source and port**
+
+Read the source file fully. Adapt:
+- Remove LEP-specific examples (search for "LEP", "lep", project-specific entity names)
+- Use generic domain examples (e.g., "rate limiter", "user authentication", "payment processor")
+- Preserve the 6 template types: concept / decision / entity / meeting / policy / comparison
+- Preserve frontmatter schema
+
+Write to target path.
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/references/page-templates.md
+git commit -m "docs(llm-wiki): port page-templates with generic domain examples (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task D2: Port ingest-workflow.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/references/ingest-workflow.md`
+- Source: `wjtb-cmc/.claude/skills/llm-wiki/references/ingest-workflow.md` (121 lines)
+
+- [ ] **Step 1: Port**
+
+Read source and port. Same generalization principle — remove LEP-specific examples, keep 5-step workflow intact.
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
+git commit -m "docs(llm-wiki): port ingest-workflow 5-step guide (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task D3: Port + adapt claude-md-block.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/references/claude-md-block.md`
+- Source: `wjtb-cmc/.claude/skills/llm-wiki/references/claude-md-block.md` (33 lines)
+
+- [ ] **Step 1: Adapt**
+
+Port with critical change: `.wiki/` → `wiki/` paths throughout. Content describes what Claude Code should do with wiki/ when present. Ensure alignment with workspace CLAUDE.md "LLM Wiki 활용 규칙":
+
+```markdown
+## LLM Wiki 활용 규칙
+
+이 프로젝트는 `wiki/` 디렉토리에 [[wiki-link]] 교차참조 위키를 유지한다. Karpathy LLM Wiki 패턴을 따른다.
+
+### 작업 시 우선순위
+
+1. **위키 우선 참조**: 질문에 답하거나 작업을 시작할 때, `wiki/index.md`에서 관련 페이지를 먼저 찾아 읽는다. `[[wiki-link]]`를 따라 2-hop까지 확장하여 맥락을 파악한다.
+2. **출처 인용**: 답변 작성 시 위키 페이지를 `[[페이지 제목]]` 형태로 인용한다.
+3. **위키에 없으면 명시**: 위키에 답이 없으면 "위키에 없음"이라 표기하고 `raw/` 또는 외부 원본을 읽어 보강한다. 새 내용이면 `llm-wiki ingest`로 위키를 성장시킨다.
+4. **검색보다 컴파일**: 매번 원본을 다시 읽지 말고, 이미 컴파일된 위키 지식을 적극 재활용한다.
+
+### 위키 구조
+
+- `wiki/index.md` — 자동 재빌드되는 라우팅 레이어 (수동 편집 금지)
+- `wiki/{page}.md` — 컴파일된 지식 페이지 ([[wiki-link]] 교차참조)
+- `wiki/raw/` — 원본 소스 드롭존 (불변)
+- `wiki/log.md` — ingest 이력
+- `wiki/.lancedb/` — 선택적 벡터 인덱스 (lancedb-sync 실행 시)
+
+### 스킬 명령
+
+사용자가 `llm-wiki <command>`를 호출하면 해당 단계 실행:
+- `init` — 구조 초기화
+- `ingest <source>` — 새 소스를 컴파일해 위키 갱신
+- `query <질문>` — 하이브리드 검색(qmd) 또는 INDEX.md 라우팅
+- `lint` — 끊어진 링크·고아 페이지 탐지
+- `sync` — index.md 재빌드
+- `export <template>` — 온보딩·ADR 요약 등 출력
+- `qmd-index` — qmd 인덱스 빌드 (선택)
+- `lancedb-sync` — LanceDB 벡터 인덱스 동기화 (선택)
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/references/claude-md-block.md
+git commit -m "docs(llm-wiki): port claude-md-block adapted to wiki/ convention (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task D4: New qmd-integration.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/references/qmd-integration.md`
+
+- [ ] **Step 1: Write**
+
+Base content on `~/Downloads/llm-wiki-qmd-vectordb-complete-report.md` §2:
+
+```markdown
+> **Snapshot date**: 2026-04-19
+> **Description**: qmd 설치·컨텍스트 등록·하이브리드 검색 옵션
+
+# qmd Integration
+
+Karpathy가 LLM Wiki 글에서 검색 백엔드로 추천한 로컬 온디바이스 하이브리드 검색 엔진. BM25 + 벡터 + LLM 재순위를 결합, node-llama-cpp로 완전히 로컬에서 실행. MIT 라이선스.
+
+## 설치
+
+### macOS
+
+```bash
+brew install qmd
+```
+
+### 기타 (Linux, Windows WSL)
+
+```bash
+npm install -g @tobilu/qmd
+```
+
+## Claude Code MCP 연동 (권장)
+
+```bash
+claude marketplace add tobi/qmd
+```
+
+6개 도구 노출: `query`, `search`, `vsearch`, `get`, `multi-get`, `status`.
+
+## 위키 인덱싱
+
+`llm-wiki qmd-index` 명령이 `qmd index wiki/`를 실행. 또는 수동:
+
+```bash
+qmd index wiki/
+qmd context add qmd://wiki "LLM Wiki: 프로젝트 컨텍스트 위키"
+```
+
+## 검색 모드
+
+| 모드 | CLI | 설명 | 속도 |
+|------|-----|------|------|
+| search | `qmd search "rate limit"` | BM25 키워드 매칭 | ~132ms |
+| vsearch | `qmd vsearch "throttling patterns"` | 벡터 시맨틱 | ~2.9초 |
+| query | `qmd query "API 제한 패턴"` | 하이브리드 (FTS + vec + LLM 재순위) | ~17-20초 |
+
+LLM Wiki의 `query` 명령은 내부적으로 `qmd query`를 호출 (qmd 감지 시).
+
+## 다국어 지원
+
+한국어/일본어는 기본 모델로도 동작하나, 품질 향상을 원하면:
+
+```bash
+export QMD_EMBED_MODEL=Qwen3-Embedding-0.6B
+qmd index wiki/  # 재인덱싱
+```
+
+## 컨텍스트 트리
+
+qmd의 킬러 피처. 컬렉션별 설명을 추가하여 검색이 문서 위치를 이해하도록:
+
+```bash
+qmd context add qmd://wiki "프로젝트 컨텍스트 위키"
+qmd context add qmd://wiki/decisions "아키텍처 결정 기록 (ADR)"
+qmd context add qmd://wiki/meetings "회의록 요약"
+```
+
+## 스마트 청킹
+
+qmd는 마크다운 헤딩·코드 블록·빈 줄에서 자동 분할, 타겟 ~900 토큰 + 15% 오버랩. 코드 블록은 중간 분할 금지. 별도 설정 불필요.
+
+## Reference links
+
+- qmd: https://github.com/tobi/qmd
+- lazyqmd (TUI): https://github.com/alexanderzeitler/lazyqmd
+- Karpathy LLM Wiki: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/references/qmd-integration.md
+git commit -m "docs(llm-wiki): add qmd-integration with install + MCP + search modes (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task D5: New lancedb-integration.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/references/lancedb-integration.md`
+
+- [ ] **Step 1: Write**
+
+Base on report §4, §5:
+
+```markdown
+> **Snapshot date**: 2026-04-19
+> **Description**: LanceDB 벡터 인덱스 + Embedding Atlas 연결
+
+# LanceDB Integration (Phase 3 optional)
+
+> **When to use**: 위키 규모 500페이지 초과, 멀티 에이전트 지식 슬라이싱, Embedding Atlas 시각화 필요 시. 500페이지 미만은 qmd만으로 충분.
+
+## 설치
+
+```bash
+pip install lancedb duckdb sentence-transformers
+```
+
+임베딩 모델은 `all-MiniLM-L6-v2` (기본, CPU 빠름) 또는 `Qwen3-Embedding-0.6B` (프로덕션 품질, 다국어).
+
+## 인덱스 생성
+
+```bash
+./scripts/lancedb_sync.py --wiki-dir ./wiki --model all-MiniLM-L6-v2
+```
+
+결과: `wiki/.lancedb/` 디렉토리에 `.lance` 파일 생성. Git에서는 `.gitignore`로 제외(기본).
+
+## Embedding Atlas 연결
+
+```bash
+pip install embedding-atlas
+atlas open wiki/.lancedb/
+```
+
+브라우저에서 WebGPU 렌더링으로 수백만 포인트 가시화. 멀티 코디네이트 뷰 교차 필터링. MCP 지원으로 Claude Code 직접 연동.
+
+## DuckDB SQL 분석
+
+LanceDB는 Lance extension for DuckDB를 통해 DuckDB와 네이티브 통합:
+
+```sql
+-- 지난 7일 미업데이트 페이지
+SELECT path, title, updated
+FROM lance_scan('wiki/.lancedb/wiki_pages.lance')
+WHERE updated < CURRENT_DATE - INTERVAL '7 days'
+ORDER BY updated ASC;
+
+-- 카테고리별 페이지 수
+SELECT type, COUNT(*) as n
+FROM lance_scan('wiki/.lancedb/wiki_pages.lance')
+GROUP BY type
+ORDER BY n DESC;
+```
+
+## 트레이드오프 (report §6.2 요약)
+
+- **장점**: 시맨틱 디스커버리, 멀티 에이전트 슬라이싱, 시각화, SQL 분석, 버전 관리 내장
+- **단점**: 복잡도 비용, 듀얼 소스 오브 트루스(md ↔ vec), 임베딩 모델 lock-in, LanceDB 베타(v0.23.x)
+- **qmd와 중복**: qmd도 이미 BM25+vec+재순위를 제공. LanceDB는 시각화·SQL·멀티슬라이싱이 필요할 때만 추가.
+
+## 단계별 채택
+
+- **Phase 1** (소스 <100): 벡터 DB 없이 Karpathy 원본 설계
+- **Phase 2** (100-500): qmd만으로 하이브리드 검색
+- **Phase 3** (500+): LanceDB + DuckDB + Embedding Atlas
+
+## Reference links
+
+- LanceDB: https://lancedb.com
+- Lance DuckDB extension: https://github.com/lancedb/lance-duckdb
+- Apple Embedding Atlas: https://github.com/apple/embedding-atlas
+- Anthropic Contextual Retrieval: https://anthropic.com/news/contextual-retrieval
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
+git commit -m "docs(llm-wiki): add lancedb-integration Phase 3 optional guide (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task D6: New karpathy-pattern.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md`
+
+- [ ] **Step 1: Write**
+
+```markdown
+> **Snapshot date**: 2026-04-19
+> **Source**: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
+> **Description**: Karpathy 원본 패턴 요약 및 본 구현 결정 기록
+
+# Karpathy LLM Wiki 패턴
+
+## 핵심 아이디어
+
+> RAG는 무상태. Wiki는 복리로 축적된다.
+
+대부분의 LLM 작업은 RAG로 매번 처음부터 지식을 재발견한다. LLM Wiki는 달리, 지속적으로 상호 연결된 지식 베이스를 **증분 구축**한다. 교차 참조가 이미 존재하고, 모순이 이미 플래그되며, 합성 결과가 이전에 수집된 모든 것을 반영한다.
+
+## 3계층 아키텍처
+
+- `raw/` — 불변 입력 문서 (LLM이 읽기만, 수정 금지)
+- `wiki/*.md` — LLM이 생성·유지하는 마크다운 (요약, 엔티티 페이지, 개념 비교, 마스터 인덱스)
+- `CLAUDE.md` — 스키마·컨벤션 (위키 구조 정의, 워크플로 지시)
+
+## 3가지 핵심 연산
+
+| 연산 | 설명 |
+|------|------|
+| Ingest | 소스를 넣으면 LLM이 10~15개 위키 페이지를 업데이트 |
+| Query | LLM이 인덱스를 검색하고 답변을 합성 |
+| Lint | 주기적 건강 점검 — 모순, 부실 주장, 고아 페이지 탐지 |
+
+## 본 구현의 확장 결정
+
+### 1. `wiki/` 노출형 선택
+
+Karpathy 원본은 별도 규정 없음. 본 구현은 워크스페이스 CLAUDE.md의 "LLM Wiki 활용 규칙"이 `wiki/index.md` 존재를 시그널로 쓰도록 규정하므로, 노출형 `wiki/`를 채택. Obsidian에서 vault로 직접 열 수 있는 이점.
+
+### 2. 명령 8개로 확장
+
+Karpathy 원본 3개(Ingest/Query/Lint) + 본 구현 추가 5개:
+- `init` — 구조 자동 생성 (Karpathy는 수동 설명만)
+- `sync` — `index.md` 결정론적 재빌드 (LLM 오류 방지)
+- `export` — 온보딩/ADR/릴리스 노트 템플릿 출력
+- `qmd-index` — 하이브리드 검색 백엔드 설정
+- `lancedb-sync` — Phase 3 벡터 인덱스
+
+### 3. qmd 통합 (Karpathy 권장)
+
+Karpathy가 LLM Wiki 글에서 qmd를 명시적으로 추천. 본 구현은 qmd 설치 감지 시 자동으로 하이브리드 검색으로 승격, 미설치 시 INDEX.md 라우팅으로 graceful degrade.
+
+### 4. LanceDB는 선택적
+
+Karpathy는 벡터 DB를 명시적으로 배제했다. 이유: 잘 큐레이션된 INDEX.md + LLM 컨텍스트 윈도우가 개인 규모 위키에는 충분. 본 구현도 이 원칙을 존중하여 500페이지 초과 또는 멀티 에이전트 시나리오에서만 권장.
+
+## 규모별 전략
+
+| 규모 | 전략 |
+|------|------|
+| <100 페이지 | Karpathy 원본 (INDEX.md + LLM 컨텍스트 윈도우) |
+| 100~500 페이지 | qmd 하이브리드 검색 활용 |
+| 500+ 페이지 | LanceDB + DuckDB + Embedding Atlas 추가 |
+
+## Obsidian 호환
+
+모든 `[[wiki-link]]`는 Obsidian 표준. 사용자는 Obsidian에서 `wiki/` vault를 열어:
+- 그래프 뷰로 교차 참조 시각화
+- 네이티브 링크 follow
+- 마크다운 프리뷰
+
+## 참고
+
+- Karpathy 원문: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
+- Karpathy 트윗: https://x.com/karpathy/status/2039805659525644595
+- Claude Code LLM Wiki 구현 사례: github.com/tinworks-ai/claude-obsidian, github.com/llm-wiki/kb-wiki
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
+git commit -m "docs(llm-wiki): add karpathy-pattern origin and design decisions (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+---
+
+## Stage E — SKILL.md body
+
+### Task E1: Write full SKILL.md
+
+**Files:**
+- Modify: `plugins/documentation/skills/llm-wiki/SKILL.md`
+
+- [ ] **Step 1: Write body (preserve frontmatter from Stage B)**
+
+Write to the SKILL.md file, preserving the existing frontmatter. Body structure:
+
+```markdown
+---
+name: llm-wiki
+description: Karpathy LLM Wiki 패턴 구현. 프로젝트 문서(스펙/ADR/회의록)를 wiki/raw/에 모으고 LLM이 컴파일하여 wiki/에 교차참조 마크다운 위키를 생성·갱신. qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB 선택적 벡터 인덱스. Obsidian 호환. 하위 명령 - init, ingest, query, lint, sync, export, qmd-index, lancedb-sync.
+argument-hint: [init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]
+---
+
+# llm-wiki — 프로젝트 컨텍스트 위키
+
+> 참고: [Karpathy LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f).
+> **검색이 아닌 컴파일**이 핵심 — 한 번 이해한 것은 계속 다듬어 재활용한다.
+
+## 언제 사용하나
+
+트리거: "wiki 초기화", "문서 wiki로 정리", "프로젝트 컨텍스트 위키", "llm wiki", "knowledge base 구축", "wiki ingest", "wiki query", "서드파티 소스 컴파일".
+
+이 스킬은 워크스페이스 CLAUDE.md의 **"LLM Wiki 활용 규칙"을 실제 실행 가능하게** 한다.
+
+## 디렉토리 구조
+
+프로젝트 루트에 `init` 명령으로 생성되는 구조:
+
+```text
+wiki/
+├── index.md              # 자동 재빌드 (수동 편집 금지)
+├── log.md                # ingest 이력
+├── raw/                  # 원본 소스 드롭존 (불변)
+│   └── YYYY-MM-DD_{source}.md
+├── {page}.md             # 컴파일된 위키 페이지 ([[wiki-link]] 교차참조)
+├── .gitignore            # raw/private/, .lancedb/ 기본 제외
+└── .lancedb/             # 선택적 벡터 인덱스 (lancedb-sync 시)
+```
+
+CLAUDE.md에는 "LLM Wiki 활용 규칙" 블록이 init 시 자동 추가된다.
+
+## 페이지 프론트매터 규약
+
+```yaml
+---
+title: "Rate Limiter Design"
+type: decision          # concept | decision | entity | meeting | policy | comparison
+tags: [api, reliability]
+status: active          # draft | active | stale | archived
+confidence: high        # high | medium | low | tentative
+created: 2026-04-19
+updated: 2026-04-19
+sources: [raw/2026-04-18_arch-review.md]
+---
+```
+
+상세는 [page-templates.md](references/page-templates.md) 참조.
+
+## 8개 명령 실행 순서
+
+### `init` — 구조 초기화
+
+**실행**: `scripts/init.sh`
+
+- `wiki/` 디렉토리 구조 생성
+- `wiki/index.md`, `log.md`, `.gitignore` 초기 파일
+- 프로젝트 루트 `CLAUDE.md`에 LLM Wiki 블록 추가 (`references/claude-md-block.md`)
+- qmd / LanceDB 환경 감지 및 안내
+
+### `ingest <source>` — 소스 컴파일
+
+상세 워크플로: [ingest-workflow.md](references/ingest-workflow.md)
+
+5단계 요약:
+1. 소스 읽기 (사용자가 `raw/`에 드롭 또는 인자로 경로 제공)
+2. 엔티티·개념 추출
+3. 기존 wiki 페이지와 교차 참조 검토
+4. 페이지 생성/갱신 (10-15 페이지)
+5. `log.md`에 기록
+
+### `query <질문>` — 위키 검색
+
+**qmd 감지 시**:
+1. `qmd query "<질문>"` 호출
+2. 하이브리드 검색 결과 top-10 수령
+3. LLM이 컨텍스트 트리 + 매칭 페이지로 답변 합성
+4. 답변에 `[[wiki-link]]`로 출처 인용
+
+**qmd 미감지 시 (graceful degrade)**:
+1. `wiki/index.md` 읽어 관련 페이지 후보 3-5개 식별
+2. 후보 페이지 본문 로드 + `[[link]]` 2-hop 확장
+3. LLM이 로드된 컨텍스트로 답변
+4. "qmd 미설치 — 하이브리드 검색 원하면 `brew install qmd`" 안내 첨부
+
+### `lint` — 건강 점검
+
+**실행**: `scripts/lint_wiki.py`
+
+검사:
+- 끊어진 `[[wiki-link]]`
+- 고아 페이지 (어디에서도 참조되지 않음)
+- frontmatter 필수 필드 누락 (`title`, `updated`)
+- `confidence: low` 또는 `tentative` 페이지 플래그
+
+### `sync` — index.md 재빌드
+
+**실행**: `scripts/sync_index.py`
+
+`wiki/*.md` 스캔 → frontmatter `type` 별로 그룹화 → `index.md` 재생성. 수동 편집은 덮어씌워지므로 index에는 내용을 쓰지 말 것.
+
+### `export <template>` — 템플릿 출력
+
+LLM이 wiki 페이지를 템플릿으로 합성. 지원 템플릿:
+- `onboarding` — 신규 팀원 온보딩 가이드
+- `adr-summary` — ADR 목록 + 요약
+- `release-notes` — 지정 기간의 변경 페이지 요약
+- `qa-export` — 축적된 Q&A 지식을 별도 문서로
+
+### `qmd-index` — qmd 인덱스 (선택)
+
+**실행**: `scripts/qmd_index.sh`
+
+qmd 설치 전제. 없으면 설치 안내 후 exit 1.
+
+### `lancedb-sync` — LanceDB 벡터 인덱스 (선택)
+
+**실행**: `scripts/lancedb_sync.py`
+
+`pip install lancedb duckdb sentence-transformers` 전제. 없으면 설치 안내 후 exit 1. 상세는 [lancedb-integration.md](references/lancedb-integration.md).
+
+## Graceful Degrade 원칙
+
+- `query`는 항상 작동 (qmd 있으면 하이브리드, 없으면 INDEX.md 라우팅)
+- 명시 명령(`qmd-index`, `lancedb-sync`)은 의존성 없으면 설치 안내 + exit 1
+- `init`은 환경을 감지만 할 뿐 종료 코드에 영향 없음
+
+## 통합 포인트
+
+### 다른 스킬과의 관계
+
+- `qa-merge`: Q&A 카드 통합 결과를 `wiki/raw/`로 드롭 → 자동 ingest 대상
+- `intent`: `INTENT.md` 변경 시 `raw/`로 복사 후 ingest → Why/What/Not/Learnings가 decision·entity 페이지로 분해
+- `korean-docs`: 한국어 출력 규칙과 직교. 위키 페이지 식별자는 영어 허용 (Obsidian 호환)
+
+### Obsidian
+
+`wiki/`를 Obsidian vault로 열면:
+- 그래프 뷰로 교차 참조 시각화
+- `[[wiki-link]]` 네이티브 네비게이션
+- 마크다운 실시간 프리뷰
+
+## Karpathy 원칙 준수
+
+- `raw/`는 LLM이 수정하지 않음 (read-only for wiki purposes)
+- `wiki/*.md`는 LLM이 증분 갱신 (컴파일)
+- CLAUDE.md가 스키마·컨벤션을 정의
+- 3가지 연산(Ingest/Query/Lint)이 핵심, 나머지는 보조
+
+## References (Progressive Disclosure)
+
+- [page-templates.md](references/page-templates.md) — 6개 페이지 유형 템플릿
+- [ingest-workflow.md](references/ingest-workflow.md) — Ingest 5단계 상세
+- [claude-md-block.md](references/claude-md-block.md) — CLAUDE.md 추가 블록 템플릿
+- [qmd-integration.md](references/qmd-integration.md) — qmd 설치·설정·MCP
+- [lancedb-integration.md](references/lancedb-integration.md) — LanceDB + Embedding Atlas (Phase 3)
+- [karpathy-pattern.md](references/karpathy-pattern.md) — 원본 패턴 + 본 구현 결정 기록
+
+## Anti-patterns
+
+- `wiki/index.md` 수동 편집 (sync에 덮어씌워짐)
+- `wiki/raw/`의 원본 수정 (불변 원칙 위반 — 새 버전을 새 파일로 드롭)
+- 페이지 제목에 한국어 공백 (Obsidian `[[link]]` 호환성 저하 — slug는 영어/하이픈 권장)
+- 모순되는 정보를 두 페이지에 분산 (합성하여 단일 페이지로 정리하는 것이 위키의 목적)
+```
+
+- [ ] **Step 2: Verify line count**
+
+```bash
+wc -l plugins/documentation/skills/llm-wiki/SKILL.md
+```
+Expected: ≤300. If over, trim examples or move details to references.
+
+- [ ] **Step 3: Run tests**
+
+```bash
+npm test
+```
+Expected: green.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add plugins/documentation/skills/llm-wiki/SKILL.md
+git commit -m "feat(llm-wiki): write 8-command orchestrator SKILL.md (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+---
+
+## Stage F — Integration
+
+### Task F1: Root README.md
+
+**Files:**
+- Modify: `README.md`
+
+- [ ] **Step 1: Add llm-wiki row**
+
+Locate `### Documentation` section. Add row to the table:
+
+```markdown
+| [llm-wiki](plugins/documentation/skills/llm-wiki) | Karpathy LLM Wiki 패턴 - 프로젝트 문서를 컴파일 위키로 유지 (qmd 하이브리드 검색, Obsidian 호환) |
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add README.md
+git commit -m "docs(readme): list llm-wiki skill in Documentation section (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task F2: plugins/documentation/README.md
+
+**Files:**
+- Modify: `plugins/documentation/README.md`
+
+- [ ] **Step 1: Add llm-wiki content**
+
+- Skills 테이블에 새 행:
+
+```markdown
+| [llm-wiki](skills/llm-wiki) | Karpathy LLM Wiki 패턴으로 프로젝트 문서를 컴파일 위키로 유지 | "위키 초기화", "wiki ingest", "프로젝트 컨텍스트 위키", "knowledge base 구축" |
+```
+
+- 특징 bullets에 추가:
+
+```markdown
+- **지식 컴파일** — `llm-wiki`가 Karpathy LLM Wiki 패턴으로 프로젝트 문서를 `wiki/`에 교차참조 마크다운으로 컴파일합니다. RAG 재검색이 아닌 복리 축적 모델.
+```
+
+- "5개 스킬" 같은 카운트 업데이트 (4 → 5)
+
+- 사용 예시에 추가:
+
+```markdown
+### 예시 N — 프로젝트 지식을 위키로 컴파일
+`llm-wiki init`으로 `wiki/` 구조를 생성하고 기존 문서를 `wiki/raw/`에 드롭한 뒤 `llm-wiki ingest`로 컴파일합니다. qmd 설치 시 하이브리드 검색이, LanceDB 설치 시 벡터 시각화(Embedding Atlas)가 자동 활성됩니다.
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add plugins/documentation/README.md
+git commit -m "docs(documentation): add llm-wiki to plugin README (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+### Task F3: CHANGELOG.md
+
+**Files:**
+- Modify: `CHANGELOG.md`
+
+- [ ] **Step 1: Add Unreleased entry**
+
+Under `[Unreleased]` → `### Added`:
+
+```markdown
+- **llm-wiki** (documentation): Karpathy LLM Wiki 패턴 구현 스킬. 8개 서브커맨드(init/ingest/query/lint/sync/export/qmd-index/lancedb-sync). qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB + Embedding Atlas 선택적 벡터 인덱스 지원. Obsidian 호환 `[[wiki-link]]`. 워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙"과 통합. (#8)
+```
+
+- [ ] **Step 2: Commit**
+
+```bash
+git add CHANGELOG.md
+git commit -m "docs(changelog): note llm-wiki skill (#8)
+
+Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+"
+```
+
+---
+
+## Stage G — Verification
+
+### Task G1: End-to-end sanity test
+
+- [ ] **Step 1: Test init + sync + lint roundtrip**
+
+```bash
+cd /tmp && rm -rf llm-wiki-e2e && mkdir llm-wiki-e2e && cd llm-wiki-e2e
+
+SKILL=/Users/dohyunjung/Workspace/roboco-io/tools/plugins/plugins/documentation/skills/llm-wiki
+
+# init
+"$SKILL/scripts/init.sh"
+
+# Add test pages
+cat > wiki/alpha.md <<'EOF'
+---
+title: Alpha
+type: concept
+tags: [core]
+status: active
+updated: 2026-04-19
+---
+# Alpha
+Related: [[beta]]
+EOF
+cat > wiki/beta.md <<'EOF'
+---
+title: Beta
+type: decision
+status: active
+updated: 2026-04-19
+confidence: high
+---
+# Beta
+Depends on [[alpha]]
+EOF
+
+# sync
+python3 "$SKILL/scripts/sync_index.py"
+cat wiki/index.md
+
+# lint (should pass — both pages referenced in index + cross-ref)
+python3 "$SKILL/scripts/lint_wiki.py"
+
+# Break link to trigger lint issue
+cat >> wiki/alpha.md <<'EOF'
+
+See [[nonexistent]] too.
+EOF
+python3 "$SKILL/scripts/lint_wiki.py"
+echo "lint exit code: $?"
+
+cd && rm -rf /tmp/llm-wiki-e2e
+```
+
+Expected:
+- init creates wiki structure + CLAUDE.md
+- sync creates index.md with 2 pages grouped by type
+- First lint passes (exit 0)
+- Second lint catches `[[nonexistent]]` broken link (exit 1)
+
+- [ ] **Step 2: Test qmd/LanceDB graceful degrade**
+
+```bash
+# qmd_index when qmd missing (if applicable)
+if ! command -v qmd >/dev/null 2>&1; then
+  $SKILL/scripts/qmd_index.sh /tmp/test-wiki
+  echo "exit code: $?"  # expect 1 with install guidance
+fi
+
+# lancedb_sync when deps missing (likely)
+python3 $SKILL/scripts/lancedb_sync.py --wiki-dir /tmp/test-wiki
+echo "exit code: $?"  # expect 1 with pip install guidance
+```
+
+Expected: both exit 1 with clear install guidance.
+
+### Task G2: Tests + final verification
+
+- [ ] **Step 1: Full test suite**
+
+```bash
+cd /Users/dohyunjung/Workspace/roboco-io/tools/plugins
+npm test
+```
+Expected: all tests pass.
+
+- [ ] **Step 2: Line count checks**
+
+```bash
+wc -l plugins/documentation/skills/llm-wiki/SKILL.md
+wc -l plugins/documentation/skills/llm-wiki/references/*.md
+```
+Expected: SKILL.md ≤300; references reasonable (≤400 each).
+
+### Task G3: Push + PR
+
+- [ ] **Step 1: Push branch**
+
+```bash
+git push -u origin feat/issue-8-llm-wiki
+```
+
+- [ ] **Step 2: Create PR**
+
+```bash
+gh pr create --base main --head feat/issue-8-llm-wiki --title "feat(documentation): add llm-wiki skill (Karpathy + qmd) (#8)" --body "$(cat <<'EOF'
+## Summary
+
+Karpathy LLM Wiki 패턴을 구현한 `llm-wiki` 스킬을 `documentation` 플러그인에 추가합니다.
+
+- 8개 서브커맨드: `init`, `ingest`, `query`, `lint`, `sync`, `export`, `qmd-index`, `lancedb-sync`
+- qmd 감지 시 하이브리드 검색 자동 활성, 미감지 시 INDEX.md 라우팅으로 graceful degrade
+- LanceDB + Embedding Atlas 선택적 벡터 인덱스 (Phase 3)
+- `wjtb-cmc/.claude/skills/llm-wiki/` 포팅 + 일반화 (LEP-특수 제거, `.wiki/` → `wiki/`)
+- 워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙"과 통합
+
+## Changes
+
+- 새 스킬 `plugins/documentation/skills/llm-wiki/`
+  - SKILL.md (≤300 lines)
+  - references/ 6개 (page-templates, ingest-workflow, claude-md-block, qmd-integration, lancedb-integration, karpathy-pattern)
+  - scripts/ 5개 (init.sh, sync_index.py, lint_wiki.py, qmd_index.sh, lancedb_sync.py)
+- `.claude-plugin/marketplace.json` 등록
+- root README, `plugins/documentation/README.md`, CHANGELOG 업데이트
+- 설계 문서: `issues/8-llm-wiki/SPEC.md`, `PLAN.md`, `TASKS.md`
+
+## Closes
+
+- #8
+
+## Test plan
+
+- [x] `npm test` 전부 green
+- [x] E2E: init + sync + lint 라운드트립 통과
+- [x] qmd/LanceDB graceful degrade 동작
+- [ ] 로컬 설치 후 실제 프로젝트에서 ingest 시나리오 검증
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+EOF
+)"
+```
+
+---
+
+## Self-Review
+
+**Spec coverage:**
+
+| SPEC § | Task |
+|--------|------|
+| §2.1 Directory layout | B1 |
+| §3 Commands (8개) | E1 (SKILL.md inline), scripts in C |
+| §4 Graceful degrade | C4, C5 (install guidance), E1 (SKILL body) |
+| §5 References 6개 | D1-D6 |
+| §6 Scripts 5개 | C1-C5 |
+| §7 Integration points | E1 (SKILL.md integration section) |
+| §8 Obsidian compat | E1, D1 (page-templates) |
+| §9 Citation rules | applied in references inline |
+| §10 Non-goals | E1 inline |
+| §11 Success criteria | G1 E2E test |
+| §12 Decisions summary | D6 karpathy-pattern.md |
+
+**Placeholder scan:** No TBD/TODO left in the plan. All code blocks complete.
+
+**Type consistency:**
+- `wiki/` used consistently (not `.wiki/`)
+- `parse_frontmatter` function matches in sync_index.py and lint_wiki.py (both stdlib-only)
+- Command names consistent: `init/ingest/query/lint/sync/export/qmd-index/lancedb-sync`
+
+---
+
+## Execution Handoff
+
+Plan complete and saved to `issues/8-llm-wiki/TASKS.md`. Two execution options:
+
+**1. Subagent-Driven (recommended)** — dispatch fresh subagent per Stage, review between stages.
+
+**2. Inline Execution** — execute in current session with stage checkpoints.
+
+Awaiting user decision.

From cef2cf40b1eff96eefecc8a5dc70dd9a4ccfc423 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:38:50 +0900
Subject: [PATCH 03/21] docs(issues/8): add PLAN for llm-wiki stage overview
 (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 issues/8-llm-wiki/PLAN.md | 126 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 126 insertions(+)
 create mode 100644 issues/8-llm-wiki/PLAN.md

diff --git a/issues/8-llm-wiki/PLAN.md b/issues/8-llm-wiki/PLAN.md
new file mode 100644
index 0000000..360643b
--- /dev/null
+++ b/issues/8-llm-wiki/PLAN.md
@@ -0,0 +1,126 @@
+# Issue #8: llm-wiki 구현 계획
+
+> **전제**: `SPEC.md` 승인 완료 (2026-04-19).
+> **구현 위치**: `plugins/documentation/skills/llm-wiki/`.
+> **총 예상 공수**: ~1.5일(1인). 포팅 0.5일 + 신규 references+scripts 0.5일 + SKILL.md+통합 0.5일.
+
+## 0. 선행 조건
+
+- [x] HANDOFF.md 읽음 (~/Downloads/LLM_WIKI_HANDOFF.md)
+- [x] Research report 읽음 (~/Downloads/llm-wiki-qmd-vectordb-complete-report.md)
+- [x] SPEC.md 작성 및 승인
+- [x] TASKS.md bite-sized 계획 작성
+- [x] 포팅 원본 접근 확인 (wjtb-cmc/.claude/skills/llm-wiki/)
+
+---
+
+## 1. 구현 단계
+
+### Stage B — 스킬 스캐폴드 (~0.2일)
+
+- SKILL.md stub (frontmatter만) + 6 reference stubs + 5 script stubs
+- `.claude-plugin/marketplace.json` documentation.skills 배열에 등록
+- `npm test` green 확인
+- **Deliverable**: 스킬 구조 존재, 내용은 이후 단계에서 채움
+
+### Stage C — 스크립트 포팅 + 신규 (~0.5일)
+
+- C1 init.sh 포팅 + `wiki/` 컨벤션 반영 + qmd/LanceDB 감지
+- C2 sync_index.py 포팅 + zero-dep frontmatter 파싱
+- C3 lint_wiki.py 포팅 + 끊어진 링크·고아·frontmatter 검증
+- C4 qmd_index.sh 신규 (qmd CLI 래퍼 + 설치 안내)
+- C5 lancedb_sync.py 신규 (LanceDB 벡터 인덱스 + 의존성 graceful)
+- 각 스크립트 sanity test로 동작 확인
+
+### Stage D — references 포팅 + 신규 (~0.5일)
+
+- D1 page-templates.md 포팅 + LEP-특수 예시 제거
+- D2 ingest-workflow.md 포팅 + 일반화
+- D3 claude-md-block.md 포팅 + `wiki/` 경로 반영 + 워크스페이스 CLAUDE.md 규칙 정렬
+- D4 qmd-integration.md 신규 (설치·MCP·검색 모드 3종)
+- D5 lancedb-integration.md 신규 (Phase 3 옵션, Embedding Atlas 연결)
+- D6 karpathy-pattern.md 신규 (원본 패턴 + 본 구현 결정 기록)
+
+### Stage E — SKILL.md 본문 (~0.2일)
+
+- E1 8-command 오케스트레이터 본문 (≤300 lines)
+- Phase 1-5 워크플로가 아닌 8개 명령 실행 순서로 구성 (SKILL.md는 sub-command dispatcher)
+- Graceful degrade 원칙 명시
+- Progressive disclosure로 상세는 references/로
+
+### Stage F — 통합 (~0.1일)
+
+- F1 root README.md Documentation 섹션에 llm-wiki 행 추가
+- F2 plugins/documentation/README.md 특징·스킬 테이블·사용 예시 업데이트
+- F3 CHANGELOG.md [Unreleased] ### Added 엔트리
+
+### Stage G — 검증 + PR (~0.1일)
+
+- G1 E2E 라운드트립: init → sync → lint (clean + broken link 감지)
+- G1 graceful degrade: qmd 없는 환경에서 qmd_index/lancedb_sync 설치 안내 exit 1
+- G2 `npm test` 전부 green
+- G2 SKILL.md 줄 수 ≤300
+- G3 브랜치 push + PR 생성 (#8 closes)
+
+---
+
+## 2. 리스크 및 완화
+
+| 리스크 | 영향 | 완화 |
+|-------|------|------|
+| wjtb-cmc 스킬에 LEP 특수 로직이 숨어있음 | 일반화 누락 시 다른 프로젝트에서 오동작 | 포팅 시 `grep -i lep`로 전부 제거 후 sanity test |
+| qmd CLI 옵션이 2026-04 기준과 달라짐 | qmd_index.sh 동작 실패 | 스크립트 상단에 snapshot 주석, qmd 미설치 graceful |
+| Python 표준에 YAML 부재 | sync_index/lint_wiki 파싱 실패 | 수동 frontmatter 파싱 (zero-dep), 복잡 YAML은 미지원 명시 |
+| LanceDB v0.23.x 베타 | API 변경 위험 | lancedb-sync.py가 LanceDB 미설치 시 graceful degrade, 버전 변경 시 스크립트 수정 |
+| 명령 8개가 많음 | SKILL.md description 토큰 낭비 | 핵심 트리거 키워드만 description에, 나머지는 argument-hint로 |
+
+---
+
+## 3. 의사결정 (구현 중)
+
+- **Python 버전**: 3.8+ (표준 라이브러리만 사용, f-string·pathlib 전제)
+- **frontmatter 파싱**: zero-dep 수동 파서 (pyyaml 의존 회피)
+- **임베딩 모델 기본**: `all-MiniLM-L6-v2` (CPU에서 빠름) — 한국어 필요 시 `Qwen3-Embedding-0.6B` 권장
+- **qmd 컨텍스트 명칭**: `qmd://wiki` (프로젝트 루트 기준 basename 사용)
+- **exit code 정책**: graceful degrade는 exit 0 + 경고, 명시 명령 의존성 미설치는 exit 1 + 설치 안내
+
+---
+
+## 4. 산출물 체크리스트
+
+- [ ] `plugins/documentation/skills/llm-wiki/SKILL.md`
+- [ ] `references/page-templates.md`
+- [ ] `references/ingest-workflow.md`
+- [ ] `references/claude-md-block.md`
+- [ ] `references/qmd-integration.md`
+- [ ] `references/lancedb-integration.md`
+- [ ] `references/karpathy-pattern.md`
+- [ ] `scripts/init.sh`
+- [ ] `scripts/sync_index.py`
+- [ ] `scripts/lint_wiki.py`
+- [ ] `scripts/qmd_index.sh`
+- [ ] `scripts/lancedb_sync.py`
+- [ ] `.claude-plugin/marketplace.json` 업데이트
+- [ ] root `README.md` 목록 업데이트
+- [ ] `plugins/documentation/README.md` 업데이트
+- [ ] `CHANGELOG.md` 엔트리
+- [ ] `npm test` green
+- [ ] E2E sanity 통과
+
+---
+
+## 5. 수락 기준
+
+SPEC §11 성공 기준 + 다음:
+
+- [ ] `npm test` 전부 green (Stage B 이후 유지)
+- [ ] SKILL.md 300줄 이하
+- [ ] 모든 references/*.md에 `Snapshot date` 표기
+- [ ] init → sync → lint 라운드트립 exit 0
+- [ ] 깨진 링크·고아 페이지 주입 시 lint exit 1
+- [ ] qmd 미설치 환경에서 `query` INDEX.md 라우팅 동작
+- [ ] `lancedb-sync` 미설치 시 `pip install` 안내 exit 1
+
+---
+
+*본 계획 생성: 2026-04-19. SPEC 승인 후 TASKS.md 기준으로 구현.*

From 600db34bf0ac27cb05b83669e66c7bc4bf6652dd Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:40:34 +0900
Subject: [PATCH 04/21] scaffold(llm-wiki): create skill + 6 reference stubs +
 5 script stubs (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 plugins/documentation/skills/llm-wiki/SKILL.md           | 9 +++++++++
 .../skills/llm-wiki/references/claude-md-block.md        | 4 ++++
 .../skills/llm-wiki/references/ingest-workflow.md        | 4 ++++
 .../skills/llm-wiki/references/karpathy-pattern.md       | 4 ++++
 .../skills/llm-wiki/references/lancedb-integration.md    | 4 ++++
 .../skills/llm-wiki/references/page-templates.md         | 4 ++++
 .../skills/llm-wiki/references/qmd-integration.md        | 4 ++++
 plugins/documentation/skills/llm-wiki/scripts/init.sh    | 3 +++
 .../skills/llm-wiki/scripts/lancedb_sync.py              | 3 +++
 .../documentation/skills/llm-wiki/scripts/lint_wiki.py   | 3 +++
 .../documentation/skills/llm-wiki/scripts/qmd_index.sh   | 3 +++
 .../documentation/skills/llm-wiki/scripts/sync_index.py  | 3 +++
 12 files changed, 48 insertions(+)
 create mode 100644 plugins/documentation/skills/llm-wiki/SKILL.md
 create mode 100644 plugins/documentation/skills/llm-wiki/references/claude-md-block.md
 create mode 100644 plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
 create mode 100644 plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
 create mode 100644 plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
 create mode 100644 plugins/documentation/skills/llm-wiki/references/page-templates.md
 create mode 100644 plugins/documentation/skills/llm-wiki/references/qmd-integration.md
 create mode 100755 plugins/documentation/skills/llm-wiki/scripts/init.sh
 create mode 100755 plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
 create mode 100755 plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
 create mode 100755 plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
 create mode 100755 plugins/documentation/skills/llm-wiki/scripts/sync_index.py

diff --git a/plugins/documentation/skills/llm-wiki/SKILL.md b/plugins/documentation/skills/llm-wiki/SKILL.md
new file mode 100644
index 0000000..c40fb5b
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/SKILL.md
@@ -0,0 +1,9 @@
+---
+name: llm-wiki
+description: Karpathy LLM Wiki 패턴 구현. 프로젝트 문서(스펙/ADR/회의록)를 wiki/raw/에 모으고 LLM이 컴파일하여 wiki/에 교차참조 마크다운 위키를 생성·갱신. qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB 선택적 벡터 인덱스. Obsidian 호환. 하위 명령 - init, ingest, query, lint, sync, export, qmd-index, lancedb-sync.
+argument-hint: [init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]
+---
+
+# llm-wiki
+
+스캐폴드 상태 — 본문은 Stage E에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/references/claude-md-block.md b/plugins/documentation/skills/llm-wiki/references/claude-md-block.md
new file mode 100644
index 0000000..57e6f86
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/references/claude-md-block.md
@@ -0,0 +1,4 @@
+> **Snapshot date**: 2026-04-19
+> **Description**: 사용자 프로젝트 CLAUDE.md에 추가할 LLM Wiki 참조 블록
+
+TBD — Stage D에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md b/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
new file mode 100644
index 0000000..1bd4bb9
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
@@ -0,0 +1,4 @@
+> **Snapshot date**: 2026-04-19
+> **Description**: Ingest 5단계 상세 가이드
+
+TBD — Stage D에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md b/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
new file mode 100644
index 0000000..4426ebd
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
@@ -0,0 +1,4 @@
+> **Snapshot date**: 2026-04-19
+> **Description**: Karpathy 원본 패턴 요약 및 본 구현 결정 기록
+
+TBD — Stage D에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md b/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
new file mode 100644
index 0000000..e445094
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
@@ -0,0 +1,4 @@
+> **Snapshot date**: 2026-04-19
+> **Description**: LanceDB 벡터 인덱스 + Embedding Atlas 연결
+
+TBD — Stage D에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/references/page-templates.md b/plugins/documentation/skills/llm-wiki/references/page-templates.md
new file mode 100644
index 0000000..db8ebbc
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/references/page-templates.md
@@ -0,0 +1,4 @@
+> **Snapshot date**: 2026-04-19
+> **Description**: 위키 페이지 6개 유형 템플릿 (concept/decision/entity/meeting/policy/comparison)
+
+TBD — Stage D에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/references/qmd-integration.md b/plugins/documentation/skills/llm-wiki/references/qmd-integration.md
new file mode 100644
index 0000000..9cf1bc0
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/references/qmd-integration.md
@@ -0,0 +1,4 @@
+> **Snapshot date**: 2026-04-19
+> **Description**: qmd 설치·컨텍스트 등록·하이브리드 검색 옵션
+
+TBD — Stage D에서 작성.
diff --git a/plugins/documentation/skills/llm-wiki/scripts/init.sh b/plugins/documentation/skills/llm-wiki/scripts/init.sh
new file mode 100755
index 0000000..b5daf51
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/scripts/init.sh
@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# llm-wiki init — Stage C에서 구현.
+exit 1
diff --git a/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py b/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
new file mode 100755
index 0000000..810f00d
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+"""llm-wiki lancedb-sync — Stage C에서 구현."""
+raise SystemExit(1)
diff --git a/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py b/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
new file mode 100755
index 0000000..678dc59
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+"""llm-wiki lint — Stage C에서 구현."""
+raise SystemExit(1)
diff --git a/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh b/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
new file mode 100755
index 0000000..4d35007
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# llm-wiki qmd-index — Stage C에서 구현.
+exit 1
diff --git a/plugins/documentation/skills/llm-wiki/scripts/sync_index.py b/plugins/documentation/skills/llm-wiki/scripts/sync_index.py
new file mode 100755
index 0000000..49116cf
--- /dev/null
+++ b/plugins/documentation/skills/llm-wiki/scripts/sync_index.py
@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+"""llm-wiki sync_index — Stage C에서 구현."""
+raise SystemExit(1)

From a60f6b8bce3326c2523aea7f38d9b7fbdf02fe5f Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:41:12 +0900
Subject: [PATCH 05/21] scaffold(llm-wiki): register in marketplace (#8)

Quote argument-hint value in SKILL.md frontmatter so YAML parser does
not read the `[...]` as a flow sequence.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .claude-plugin/marketplace.json                | 3 ++-
 plugins/documentation/skills/llm-wiki/SKILL.md | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 8ca70ee..820ac61 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -63,7 +63,8 @@
         "./skills/korean-docs/SKILL.md",
         "./skills/qa/SKILL.md",
         "./skills/qa-list/SKILL.md",
-        "./skills/qa-merge/SKILL.md"
+        "./skills/qa-merge/SKILL.md",
+        "./skills/llm-wiki/SKILL.md"
       ]
     },
     {
diff --git a/plugins/documentation/skills/llm-wiki/SKILL.md b/plugins/documentation/skills/llm-wiki/SKILL.md
index c40fb5b..aac6640 100644
--- a/plugins/documentation/skills/llm-wiki/SKILL.md
+++ b/plugins/documentation/skills/llm-wiki/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: llm-wiki
 description: Karpathy LLM Wiki 패턴 구현. 프로젝트 문서(스펙/ADR/회의록)를 wiki/raw/에 모으고 LLM이 컴파일하여 wiki/에 교차참조 마크다운 위키를 생성·갱신. qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB 선택적 벡터 인덱스. Obsidian 호환. 하위 명령 - init, ingest, query, lint, sync, export, qmd-index, lancedb-sync.
-argument-hint: [init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]
+argument-hint: "[init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]"
 ---
 
 # llm-wiki

From a389fcb587db4c009f884f771bb664f7a7a8b8fe Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:44:23 +0900
Subject: [PATCH 06/21] feat(llm-wiki): port init.sh with wiki/ convention and
 env detection (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../skills/llm-wiki/scripts/init.sh           | 88 ++++++++++++++++++-
 1 file changed, 86 insertions(+), 2 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/scripts/init.sh b/plugins/documentation/skills/llm-wiki/scripts/init.sh
index b5daf51..db7e845 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/init.sh
+++ b/plugins/documentation/skills/llm-wiki/scripts/init.sh
@@ -1,3 +1,87 @@
 #!/usr/bin/env bash
-# llm-wiki init — Stage C에서 구현.
-exit 1
+# llm-wiki init — 프로젝트 루트에 wiki/ 구조 초기화.
+# Usage: ./init.sh [project-root]
+set -euo pipefail
+
+PROJECT_ROOT="${1:-$PWD}"
+WIKI_DIR="$PROJECT_ROOT/wiki"
+RAW_DIR="$WIKI_DIR/raw"
+CLAUDE_MD="$PROJECT_ROOT/CLAUDE.md"
+SKILL_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+CLAUDE_BLOCK_TPL="$SKILL_DIR/references/claude-md-block.md"
+
+echo "→ llm-wiki init at: $PROJECT_ROOT"
+
+mkdir -p "$WIKI_DIR" "$RAW_DIR"
+
+if [ ! -f "$WIKI_DIR/index.md" ]; then
+  cat > "$WIKI_DIR/index.md" <<EOF
+# Wiki Index
+
+> 이 파일은 \`sync_index.py\`로 자동 재빌드됩니다. 수동 편집하지 마세요.
+
+## 페이지 목록
+
+(sync 실행 전)
+EOF
+  echo "  ✓ wiki/index.md"
+fi
+
+if [ ! -f "$WIKI_DIR/log.md" ]; then
+  cat > "$WIKI_DIR/log.md" <<EOF
+# Wiki Log
+
+Ingest 이력 타임라인. 최신 항목이 위.
+
+EOF
+  echo "  ✓ wiki/log.md"
+fi
+
+if [ ! -f "$WIKI_DIR/.gitignore" ]; then
+  cat > "$WIKI_DIR/.gitignore" <<EOF
+# llm-wiki defaults
+raw/private/
+.lancedb/
+EOF
+  echo "  ✓ wiki/.gitignore"
+fi
+
+if [ -f "$CLAUDE_MD" ]; then
+  if ! grep -q "LLM Wiki 활용 규칙" "$CLAUDE_MD" 2>/dev/null; then
+    if [ -f "$CLAUDE_BLOCK_TPL" ]; then
+      echo "" >> "$CLAUDE_MD"
+      cat "$CLAUDE_BLOCK_TPL" >> "$CLAUDE_MD"
+      echo "  ✓ CLAUDE.md에 LLM Wiki 블록 추가"
+    else
+      echo "  ⚠ CLAUDE.md 블록 템플릿 미존재 (Stage D에서 작성): $CLAUDE_BLOCK_TPL"
+    fi
+  else
+    echo "  = CLAUDE.md 이미 LLM Wiki 블록 존재 — 건너뜀"
+  fi
+else
+  if [ -f "$CLAUDE_BLOCK_TPL" ]; then
+    cat "$CLAUDE_BLOCK_TPL" > "$CLAUDE_MD"
+    echo "  ✓ CLAUDE.md 생성"
+  else
+    echo "  ⚠ CLAUDE.md 블록 템플릿 미존재 — CLAUDE.md 생성 건너뜀"
+  fi
+fi
+
+echo ""
+echo "→ 환경 감지:"
+if command -v qmd >/dev/null 2>&1; then
+  echo "  ✓ qmd 감지 — 하이브리드 검색 활성 가능. 'qmd-index' 명령 실행 권장."
+else
+  echo "  ⚠ qmd 미감지 — INDEX.md 라우팅 모드로 동작. 하이브리드 검색 원하면:"
+  echo "    brew install qmd   # macOS"
+  echo "    npm install -g @tobilu/qmd   # 기타"
+fi
+
+if python3 -c "import lancedb" >/dev/null 2>&1; then
+  echo "  ✓ LanceDB 감지 — 벡터 인덱스 활성 가능. 'lancedb-sync' 명령 실행 권장."
+else
+  echo "  ⚠ LanceDB 미감지 (선택). 원하면: pip install lancedb duckdb sentence-transformers"
+fi
+
+echo ""
+echo "✓ llm-wiki init 완료."

From a226bf79b60a212ebd558f3348083524e7590be6 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:44:52 +0900
Subject: [PATCH 07/21] feat(llm-wiki): port sync_index.py with zero-dep
 frontmatter parsing (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../skills/llm-wiki/scripts/sync_index.py     | 119 +++++++++++++++++-
 1 file changed, 117 insertions(+), 2 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/scripts/sync_index.py b/plugins/documentation/skills/llm-wiki/scripts/sync_index.py
index 49116cf..cb99aea 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/sync_index.py
+++ b/plugins/documentation/skills/llm-wiki/scripts/sync_index.py
@@ -1,3 +1,118 @@
 #!/usr/bin/env python3
-"""llm-wiki sync_index — Stage C에서 구현."""
-raise SystemExit(1)
+"""Rebuild wiki/index.md by scanning wiki/*.md for frontmatter and links.
+
+Usage:
+    ./sync_index.py [--wiki-dir PATH]
+
+Default --wiki-dir is ./wiki relative to CWD.
+Zero-dependency (stdlib only).
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+from collections import defaultdict
+
+FRONTMATTER_RE = re.compile(r'\A---\n(.*?)\n---\n', re.DOTALL)
+
+
+def parse_frontmatter(text):
+    """Minimal zero-dep YAML-ish frontmatter parser.
+
+    Supports: key: value, key: [a, b, c] (inline list), key: "quoted value".
+    Does NOT support: nested dicts, block lists, multi-line scalars.
+    """
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    result = {}
+    for line in m.group(1).splitlines():
+        stripped = line.strip()
+        if not stripped or stripped.startswith('#'):
+            continue
+        if ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        k = k.strip()
+        v = v.strip()
+        if v.startswith('[') and v.endswith(']'):
+            v = [x.strip().strip('"\'') for x in v[1:-1].split(',') if x.strip()]
+        elif (v.startswith('"') and v.endswith('"')) or (v.startswith("'") and v.endswith("'")):
+            v = v[1:-1]
+        result[k] = v
+    return result
+
+
+def collect_pages(wiki_dir):
+    """Scan wiki_dir for *.md (excluding index.md, log.md, raw/ subtree)."""
+    pages = []
+    for md in wiki_dir.rglob('*.md'):
+        if md.name in ('index.md', 'log.md'):
+            continue
+        rel_parts = md.relative_to(wiki_dir).parts
+        if 'raw' in rel_parts:
+            continue
+        text = md.read_text(encoding='utf-8')
+        fm = parse_frontmatter(text)
+        tags_field = fm.get('tags', [])
+        if isinstance(tags_field, str):
+            tags = [tags_field] if tags_field else []
+        elif isinstance(tags_field, list):
+            tags = tags_field
+        else:
+            tags = []
+        pages.append({
+            'path': md.relative_to(wiki_dir),
+            'title': fm.get('title', md.stem),
+            'type': fm.get('type', 'page'),
+            'tags': tags,
+            'status': fm.get('status', ''),
+            'updated': fm.get('updated', ''),
+        })
+    return pages
+
+
+def render_index(pages):
+    """Render index.md content grouped by type."""
+    lines = [
+        '# Wiki Index',
+        '',
+        '> 이 파일은 `sync_index.py`로 자동 재빌드됩니다. 수동 편집하지 마세요.',
+        f'> 총 {len(pages)}개 페이지.',
+        '',
+    ]
+    groups = defaultdict(list)
+    for p in pages:
+        groups[p['type']].append(p)
+    for type_name in sorted(groups.keys()):
+        lines.append(f'## {type_name.capitalize()} ({len(groups[type_name])})')
+        lines.append('')
+        for p in sorted(groups[type_name], key=lambda x: str(x['path'])):
+            tags_str = f" — tags: {', '.join(p['tags'])}" if p['tags'] else ''
+            status_str = f" [{p['status']}]" if p['status'] else ''
+            lines.append(f"- [[{p['path'].stem}|{p['title']}]]{status_str}{tags_str}")
+        lines.append('')
+    return '\n'.join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__.split('\n')[0])
+    parser.add_argument('--wiki-dir', default='./wiki',
+                        help='wiki directory (default ./wiki)')
+    args = parser.parse_args()
+
+    wiki_dir = Path(args.wiki_dir).resolve()
+    if not wiki_dir.is_dir():
+        print(f"error: wiki directory not found: {wiki_dir}", file=sys.stderr)
+        return 1
+
+    pages = collect_pages(wiki_dir)
+    index_content = render_index(pages)
+    index_path = wiki_dir / 'index.md'
+    index_path.write_text(index_content, encoding='utf-8')
+    print(f"✓ {index_path} 재빌드 완료 ({len(pages)} 페이지)")
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

From 4b828012470bb31f86d236f57913d778d9cce246 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:45:19 +0900
Subject: [PATCH 08/21] feat(llm-wiki): port lint_wiki.py with
 link/orphan/frontmatter checks (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../skills/llm-wiki/scripts/lint_wiki.py      | 121 +++++++++++++++++-
 1 file changed, 119 insertions(+), 2 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py b/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
index 678dc59..d84006f 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
+++ b/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
@@ -1,3 +1,120 @@
 #!/usr/bin/env python3
-"""llm-wiki lint — Stage C에서 구현."""
-raise SystemExit(1)
+"""Lint wiki/*.md for broken links, orphans, and missing frontmatter.
+
+Usage:
+    ./lint_wiki.py [--wiki-dir PATH]
+
+Exit code 0 if clean, 1 if issues.
+Zero-dependency (stdlib only).
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+
+WIKILINK_RE = re.compile(r'\[\[([^\]|]+)(?:\|[^\]]+)?\]\]')
+FRONTMATTER_RE = re.compile(r'\A---\n(.*?)\n---\n', re.DOTALL)
+REQUIRED_FM = ['title', 'updated']
+
+
+def parse_frontmatter(text):
+    """Minimal zero-dep frontmatter parser (matches sync_index.py)."""
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    result = {}
+    for line in m.group(1).splitlines():
+        stripped = line.strip()
+        if not stripped or stripped.startswith('#') or ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        k = k.strip()
+        v = v.strip()
+        if (v.startswith('"') and v.endswith('"')) or (v.startswith("'") and v.endswith("'")):
+            v = v[1:-1]
+        result[k] = v
+    return result
+
+
+def lint(wiki_dir):
+    md_files = []
+    for p in wiki_dir.rglob('*.md'):
+        rel_parts = p.relative_to(wiki_dir).parts
+        if 'raw' in rel_parts:
+            continue
+        md_files.append(p)
+
+    page_stems = {
+        p.stem for p in md_files
+        if p.name not in ('index.md', 'log.md')
+    }
+
+    issues = []
+    referenced = set()
+
+    for md in md_files:
+        text = md.read_text(encoding='utf-8')
+
+        if md.name in ('index.md', 'log.md'):
+            for link in WIKILINK_RE.findall(text):
+                referenced.add(link.strip())
+                target = link.strip()
+                if target not in page_stems:
+                    issues.append(
+                        f"{md.relative_to(wiki_dir)}: broken link [[{target}]]"
+                    )
+            continue
+
+        fm = parse_frontmatter(text)
+
+        for field in REQUIRED_FM:
+            if field not in fm or not fm[field]:
+                issues.append(
+                    f"{md.relative_to(wiki_dir)}: frontmatter `{field}` missing"
+                )
+
+        confidence = fm.get('confidence', '').lower() if isinstance(fm.get('confidence', ''), str) else ''
+        if confidence in ('low', 'tentative'):
+            issues.append(
+                f"{md.relative_to(wiki_dir)}: low-confidence page flagged"
+            )
+
+        for link in WIKILINK_RE.findall(text):
+            target = link.strip()
+            referenced.add(target)
+            if target not in page_stems:
+                issues.append(
+                    f"{md.relative_to(wiki_dir)}: broken link [[{target}]]"
+                )
+
+    orphans = page_stems - referenced
+    for orphan in sorted(orphans):
+        issues.append(f"wiki/{orphan}.md: orphan (not referenced from any page)")
+
+    return issues
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__.split('\n')[0])
+    parser.add_argument('--wiki-dir', default='./wiki')
+    args = parser.parse_args()
+
+    wiki_dir = Path(args.wiki_dir).resolve()
+    if not wiki_dir.is_dir():
+        print(f"error: wiki directory not found: {wiki_dir}", file=sys.stderr)
+        return 1
+
+    issues = lint(wiki_dir)
+    if not issues:
+        total = sum(1 for _ in wiki_dir.rglob('*.md'))
+        print(f"✓ clean ({total} files)")
+        return 0
+
+    print(f"⚠ {len(issues)} issue(s):", file=sys.stderr)
+    for issue in issues:
+        print(f"  - {issue}", file=sys.stderr)
+    return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())

From 44f51b6a16a9cc308aad88a68b4fa47bba2df887 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:45:38 +0900
Subject: [PATCH 09/21] feat(llm-wiki): add qmd_index.sh wrapper with install
 guidance (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../skills/llm-wiki/scripts/qmd_index.sh      | 29 +++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh b/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
index 4d35007..b656252 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
+++ b/plugins/documentation/skills/llm-wiki/scripts/qmd_index.sh
@@ -1,3 +1,28 @@
 #!/usr/bin/env bash
-# llm-wiki qmd-index — Stage C에서 구현.
-exit 1
+# llm-wiki qmd-index — qmd 인덱스 빌드/갱신.
+# Usage: ./qmd_index.sh [wiki-dir]
+set -euo pipefail
+
+WIKI_DIR="${1:-./wiki}"
+
+if [ ! -d "$WIKI_DIR" ]; then
+  echo "error: wiki directory not found: $WIKI_DIR" >&2
+  exit 1
+fi
+
+if ! command -v qmd >/dev/null 2>&1; then
+  echo "error: qmd 미설치. 설치 후 재시도:" >&2
+  echo "  brew install qmd          # macOS" >&2
+  echo "  npm install -g @tobilu/qmd  # 기타" >&2
+  exit 1
+fi
+
+echo "→ qmd index $WIKI_DIR"
+qmd index "$WIKI_DIR"
+
+ABS_WIKI="$(cd "$WIKI_DIR" && pwd)"
+CONTEXT_NAME="qmd://$(basename "$ABS_WIKI")"
+qmd context add "$CONTEXT_NAME" \
+  "LLM Wiki: 프로젝트 컨텍스트 위키 (Karpathy 패턴)" 2>/dev/null || true
+
+echo "✓ qmd-index 완료. 검색: qmd query \"<질문>\""

From dbc31770e73d913e28e4f25b125b516b50494fe3 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:46:01 +0900
Subject: [PATCH 10/21] feat(llm-wiki): add lancedb_sync.py with graceful dep
 fallback (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../skills/llm-wiki/scripts/lancedb_sync.py   | 107 +++++++++++++++++-
 1 file changed, 105 insertions(+), 2 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py b/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
index 810f00d..83945eb 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
+++ b/plugins/documentation/skills/llm-wiki/scripts/lancedb_sync.py
@@ -1,3 +1,106 @@
 #!/usr/bin/env python3
-"""llm-wiki lancedb-sync — Stage C에서 구현."""
-raise SystemExit(1)
+"""Sync wiki/*.md into a LanceDB vector index at wiki/.lancedb/.
+
+Requires: pip install lancedb duckdb sentence-transformers
+
+Usage:
+    ./lancedb_sync.py [--wiki-dir PATH] [--model MODEL] [--table TABLE]
+
+Graceful failure: exits 1 with pip install guidance if deps missing.
+"""
+import argparse
+import re
+import sys
+from pathlib import Path
+
+FRONTMATTER_RE = re.compile(r'\A---\n(.*?)\n---\n', re.DOTALL)
+
+
+def parse_frontmatter(text):
+    m = FRONTMATTER_RE.match(text)
+    if not m:
+        return {}
+    result = {}
+    for line in m.group(1).splitlines():
+        stripped = line.strip()
+        if not stripped or stripped.startswith('#') or ':' not in line:
+            continue
+        k, v = line.split(':', 1)
+        k = k.strip()
+        v = v.strip()
+        if (v.startswith('"') and v.endswith('"')) or (v.startswith("'") and v.endswith("'")):
+            v = v[1:-1]
+        result[k] = v
+    return result
+
+
+def strip_frontmatter(text):
+    m = FRONTMATTER_RE.match(text)
+    return text[m.end():] if m else text
+
+
+def main():
+    parser = argparse.ArgumentParser(description=__doc__.split('\n')[0])
+    parser.add_argument('--wiki-dir', default='./wiki')
+    parser.add_argument('--model', default='all-MiniLM-L6-v2',
+                        help='sentence-transformers model name')
+    parser.add_argument('--table', default='wiki_pages')
+    args = parser.parse_args()
+
+    try:
+        import lancedb
+        from sentence_transformers import SentenceTransformer
+    except ImportError as e:
+        missing = getattr(e, 'name', 'unknown')
+        print(f"error: 필수 의존성 누락 ({missing}). 설치:", file=sys.stderr)
+        print("  pip install lancedb duckdb sentence-transformers", file=sys.stderr)
+        return 1
+
+    wiki_dir = Path(args.wiki_dir).resolve()
+    if not wiki_dir.is_dir():
+        print(f"error: wiki directory not found: {wiki_dir}", file=sys.stderr)
+        return 1
+
+    db_dir = wiki_dir / '.lancedb'
+    db_dir.mkdir(exist_ok=True)
+
+    print(f"→ 임베딩 모델 로드: {args.model}")
+    model = SentenceTransformer(args.model)
+
+    records = []
+    for md in wiki_dir.rglob('*.md'):
+        if md.name in ('index.md', 'log.md'):
+            continue
+        rel_parts = md.relative_to(wiki_dir).parts
+        if 'raw' in rel_parts:
+            continue
+        text = md.read_text(encoding='utf-8')
+        fm = parse_frontmatter(text)
+        body = strip_frontmatter(text)
+        if not body.strip():
+            continue
+        vec = model.encode(body).tolist()
+        records.append({
+            'path': str(md.relative_to(wiki_dir)),
+            'title': fm.get('title', md.stem),
+            'type': fm.get('type', 'page'),
+            'vector': vec,
+            'text': body[:10000],
+        })
+
+    if not records:
+        print("⚠ 인덱싱할 페이지가 없음.")
+        return 0
+
+    print(f"→ LanceDB 테이블 '{args.table}' 갱신 ({len(records)} 페이지)")
+    db = lancedb.connect(str(db_dir))
+    if args.table in db.table_names():
+        db.drop_table(args.table)
+    db.create_table(args.table, data=records)
+
+    print(f"✓ lancedb-sync 완료. Embedding Atlas: atlas open {db_dir}")
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

From eed0e73f40fc4255cdca2fa603c32cfe571da2a0 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:49:41 +0900
Subject: [PATCH 11/21] docs(llm-wiki): port page-templates with generic domain
 examples (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../llm-wiki/references/page-templates.md     | 257 +++++++++++++++++-
 1 file changed, 256 insertions(+), 1 deletion(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/page-templates.md b/plugins/documentation/skills/llm-wiki/references/page-templates.md
index db8ebbc..3edfb00 100644
--- a/plugins/documentation/skills/llm-wiki/references/page-templates.md
+++ b/plugins/documentation/skills/llm-wiki/references/page-templates.md
@@ -1,4 +1,259 @@
 > **Snapshot date**: 2026-04-19
 > **Description**: 위키 페이지 6개 유형 템플릿 (concept/decision/entity/meeting/policy/comparison)
 
-TBD — Stage D에서 작성.
+# 페이지 템플릿
+
+ingest 단계에서 페이지 유형을 고르고 아래 템플릿 중 하나를 채워 `wiki/{slug}.md`에 저장한다.
+`last_updated`는 오늘 날짜, `sources`는 raw 파일 경로를 반드시 기록한다.
+
+---
+
+## 1. concept — 개념/아이디어/설명
+
+```markdown
+---
+title: {개념명}
+aliases: [{영문명}, {약어}]
+type: concept
+status: stable
+confidence: high
+last_updated: YYYY-MM-DD
+sources:
+  - wiki/raw/YYYY-MM-DD_source.md
+related: [[{related-page}]]
+---
+
+# {개념명}
+
+> 한 줄 정의.
+
+## 배경
+왜 이 개념이 존재하는가.
+
+## 핵심 내용
+- 요점 1 ([[관련 페이지]])
+- 요점 2
+
+## 주의사항 / 오해
+흔히 틀리는 부분.
+
+## 참고
+- 출처 링크
+```
+
+**예시 주제**: Rate Limiter, Token Bucket, JWT, Idempotency Key.
+
+---
+
+## 2. entity — 시스템 엔티티/컴포넌트/서비스
+
+```markdown
+---
+title: {엔티티명}
+aliases: [{영문명}, {약어}]
+type: entity
+status: stable
+confidence: medium
+last_updated: YYYY-MM-DD
+sources:
+  - wiki/raw/...
+related: [[User Authentication]], [[Payment Processor]]
+---
+
+# Rate Limiter — API 속도 제한 서비스
+
+## 책임
+이 엔티티가 담당하는 범위.
+
+## 인터페이스
+- Input: `request(user_id, endpoint) → allow | deny`
+- Config: `limits.yaml` (endpoint 별 RPS 임계치)
+
+## 내부 구조
+- [[Token Bucket]] 알고리즘 사용
+- Redis 상태 저장 ([[Redis Cluster]])
+
+## 의존
+- [[User Authentication]] — user_id 해석
+- [[Metrics Pipeline]] — 거부율 전송
+
+## 코드 위치
+- `services/rate-limiter/`
+- 주요 파일: {개수}
+```
+
+**예시 주제**: Rate Limiter, User Authentication, Payment Processor, Notification Service.
+
+---
+
+## 3. decision — Architectural Decision Record
+
+```markdown
+---
+title: ADR-{번호} {결정 제목}
+type: decision
+status: stable      # proposed | stable | deprecated | superseded
+confidence: high
+last_updated: YYYY-MM-DD
+sources:
+  - wiki/raw/...
+related: [[관련 ADR]], [[영향받은 컴포넌트]]
+---
+
+# ADR-{번호}: {결정 제목}
+
+- **일자**: YYYY-MM-DD
+- **상태**: Accepted
+- **결정권자**: {이름/팀}
+
+## 맥락
+왜 결정이 필요했는가.
+
+## 결정
+무엇을 결정했는가.
+
+## 대안
+- A안: 채택. 근거…
+- B안: 기각. 근거…
+
+## 결과
+긍정적 결과와 트레이드오프.
+
+## 참고
+- 회의록 링크
+```
+
+**예시 주제**: "ADR-007 Rate Limiter에 Redis 대신 Memcached 사용", "ADR-012 JWT 서명 알고리즘 RS256으로 전환".
+
+---
+
+## 4. meeting — 회의록/논의 요약
+
+```markdown
+---
+title: {YYYY-MM-DD} {회의 주제}
+type: meeting
+status: stable
+confidence: medium
+last_updated: YYYY-MM-DD
+sources:
+  - wiki/raw/YYYY-MM-DD_meeting_{topic}.md
+related: [[관련 결정]], [[관련 엔티티]]
+---
+
+# {회의 제목}
+
+- **일자**: YYYY-MM-DD
+- **참석자**: {이름 목록}
+- **주제**: 한 줄 요약
+
+## 논의 내용
+1. 안건 1 — 결과
+2. 안건 2 — 결과
+
+## 결정 사항
+- [[ADR-XXX]]로 분리 기록
+- 즉시 적용: ...
+
+## 액션 아이템
+- [ ] {담당자}: {할 일} — {기한}
+
+## 미결 사안
+- 후속 논의 필요한 주제
+```
+
+**예시 주제**: "2026-03-14 Payment Processor 재시도 정책 회의", "Rate Limiter SLA 리뷰 킥오프".
+
+---
+
+## 5. policy — 정책/규칙/요구사항
+
+```markdown
+---
+title: {정책명}
+type: policy
+status: draft       # draft가 오래되면 lint가 경고
+confidence: medium
+last_updated: YYYY-MM-DD
+sources:
+  - wiki/raw/...
+related: [[관련 엔티티]]
+---
+
+# {정책명}
+
+## 목적
+이 정책이 해결하는 문제.
+
+## 규칙
+- [ ] 규칙 1
+- [ ] 규칙 2
+
+## 적용 범위
+- 해당되는 시스템/팀
+- 제외 대상
+
+## 위반 시 대응
+- 탐지 방법
+- 복구 절차
+
+## 미해결 이슈
+- 열린 질문
+```
+
+**예시 주제**: "신규 가입 계정 Rate Limit 정책", "PCI 결제 데이터 보관 기간 정책", "Access Token 만료 정책".
+
+---
+
+## 6. comparison — 대안 비교/트레이드오프
+
+```markdown
+---
+title: {주제} 비교 — {옵션 A} vs {옵션 B}
+type: comparison
+status: stable
+confidence: medium
+last_updated: YYYY-MM-DD
+sources:
+  - wiki/raw/...
+related: [[관련 결정]], [[관련 개념]]
+---
+
+# Rate Limiter 알고리즘 비교 — Token Bucket vs Leaky Bucket
+
+## 요약
+각 옵션의 한 줄 요약과 추천 기준.
+
+## 비교표
+| 기준 | Token Bucket | Leaky Bucket |
+|------|--------------|--------------|
+| 버스트 허용 | O | X |
+| 구현 복잡도 | 중 | 낮음 |
+| 메모리 사용 | 낮음 | 낮음 |
+| 평활화 | 부분 | 완전 |
+
+## 사용 맥락
+- Token Bucket: API gateway 짧은 버스트 허용
+- Leaky Bucket: 다운스트림 보호 (일정 속도 유지)
+
+## 관련 결정
+- [[ADR-007]] 본 프로젝트는 Token Bucket 채택
+
+## 참고
+- 출처 링크
+```
+
+**예시 주제**: "JWT vs Session Token", "OAuth2 vs SAML", "Stripe vs Adyen 결제 처리".
+
+---
+
+## 어떤 템플릿을 선택할지
+
+- 문서가 "무엇인가"를 설명 → **concept**
+- 시스템 구성요소/서비스/모듈 단위 → **entity**
+- 결정의 이유와 트레이드오프 → **decision**
+- 회의·브레인스토밍 결과 → **meeting**
+- "반드시 지켜야 하는 규칙" → **policy**
+- 두 가지 이상 대안 비교 → **comparison**
+
+애매하면 concept로 시작하고, 내용이 커지면 분할한다.

From 9cd2a463c6ab8ee42ea30120d882bf2920804c88 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:50:22 +0900
Subject: [PATCH 12/21] docs(llm-wiki): port ingest-workflow 5-step guide (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../llm-wiki/references/ingest-workflow.md    | 123 +++++++++++++++++-
 1 file changed, 122 insertions(+), 1 deletion(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md b/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
index 1bd4bb9..f452b6d 100644
--- a/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
+++ b/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
@@ -1,4 +1,125 @@
 > **Snapshot date**: 2026-04-19
 > **Description**: Ingest 5단계 상세 가이드
 
-TBD — Stage D에서 작성.
+# Ingest 5단계 상세
+
+`llm-wiki ingest {source}` 호출 시 따르는 단계별 프로토콜.
+
+---
+
+## 1. 수집 (Collect)
+
+**입력 형태별 처리:**
+
+- **로컬 파일**: `cp {source} wiki/raw/$(date +%F)_{basename}`
+  이미 같은 경로에 있으면 건너뛰고 경고.
+- **URL**: WebFetch로 가져와 `wiki/raw/$(date +%F)_{slug}.md`에 저장.
+  frontmatter에 `source_url`을 꼭 남긴다.
+- **대화/메모**: 사용자가 붙여넣은 텍스트는 `wiki/raw/$(date +%F)_note_{topic}.md`로 저장.
+- **기존 프로젝트 문서** (`docs/architecture.md` 등): 원본을 복사하지 않고
+  `wiki/raw/$(date +%F)_ref_{name}.md`에 **포인터만** 기록:
+  ```markdown
+  # Pointer: docs/architecture.md
+  source: ../../docs/architecture.md
+  ingested_at: YYYY-MM-DD
+  ```
+  프로젝트 내부 문서는 중복 저장하지 말고 포인터로 다룬다.
+
+**금지**:
+- raw/ 파일을 사후 편집 — 갱신은 새 날짜 파일을 만들어라.
+- 바이너리/이미지 raw 보관 — 별도 경로에 두고 경로만 적어라.
+
+---
+
+## 2. 추출 (Extract)
+
+**먼저 기존 위키를 읽는다.**
+
+1. `wiki/index.md`를 Read해 현재 페이지 목록 파악
+2. 원본에서 다루는 주제의 키워드로 기존 페이지 존재 여부 확인
+3. 원본에서 아래 유형의 정보를 식별:
+   - **개념/용어** → concept
+   - **시스템 컴포넌트/서비스** → entity
+   - **결정/선택/트레이드오프** → decision
+   - **회의·논의 요약** → meeting
+   - **규칙/정책/요구사항** → policy
+   - **대안 비교** → comparison
+
+**중복 판단 기준:**
+- 제목이 같거나 alias가 겹치면 **갱신**
+- 동일 주제지만 관점이 다르면 **관련 링크**로 연결하고 분리 생성
+- 판단이 애매하면 사용자에게 확인
+
+---
+
+## 3. 작성 (Write)
+
+- `references/page-templates.md`에서 유형에 맞는 템플릿 선택
+- 프론트매터 필수 필드 모두 채움:
+  - `title`, `type`, `status`, `confidence`, `last_updated`, `sources`
+- 본문은 가급적 `[[wiki-link]]`로 다른 페이지와 연결
+- 확신이 낮은 부분은 `confidence: low` + 본문에 `> ⚠ 확인 필요:` 표기
+- 아직 존재하지 않는 대상 페이지는 `[[새페이지#stub]]`로 남겨둠
+  (lint가 stub 감지 → 다음 ingest에서 실체화)
+
+**갱신 시 원칙**:
+- 기존 본문을 통째로 덮어쓰지 않는다. 변경 섹션만 교체하거나 추가.
+- `last_updated`를 오늘 날짜로
+- `sources:`에 새 raw 경로를 append
+- `confidence`는 상향만, 사용자 지시 없이 하향 금지
+
+---
+
+## 4. 기록 (Log)
+
+`wiki/log.md`에 한 줄 추가:
+
+```
+- YYYY-MM-DD | wiki/raw/YYYY-MM-DD_source.md | +3 ~2 | Rate Limiter 토큰버킷 정책 추출
+```
+
+- `+N`: 새로 만든 페이지 수
+- `~N`: 갱신한 페이지 수
+- 요약: 20자 내외, 한국어 OK
+
+---
+
+## 5. 동기화 (Sync & Lint)
+
+순서대로 실행:
+
+```bash
+python .claude/skills/llm-wiki/scripts/sync_index.py
+python .claude/skills/llm-wiki/scripts/lint_wiki.py
+```
+
+**결과 처리:**
+
+- `sync_index.py`: 새 페이지가 index에 반영되었는지 출력 확인
+- `lint_wiki.py`:
+  - 끊어진 링크 → 타겟을 stub으로 바꾸거나 해당 페이지를 즉시 생성
+  - 고아 페이지 → index.md는 자동 처리되지만, 다른 페이지에서 `[[링크]]`를 걸 기회를 찾는다
+  - frontmatter 누락 → 즉시 수정
+  - stale draft → 사용자에게 보고 (자동 갱신 금지)
+
+**ingest 완료 보고 포맷** (사용자에게):
+
+```
+✓ ingest 완료: {source}
+  • 저장: wiki/raw/{path}
+  • 새 페이지: [[Rate Limiter]], [[Token Bucket]]
+  • 갱신: [[User Authentication]]
+  • lint: broken 0, orphan 1, stub 2
+  • 다음 제안: {stub 페이지 중 우선순위 높은 것}을 ingest 하시겠습니까?
+```
+
+---
+
+## 실패 모드와 회피
+
+| 증상 | 원인 | 대응 |
+|---|---|---|
+| 같은 개념이 여러 페이지로 파편화 | 단계 2에서 기존 페이지 확인 누락 | 매 ingest마다 index.md를 먼저 Read |
+| 링크 무덤 (링크만 있고 내용 없음) | 템플릿 채우기 회피 | confidence: low라도 본문 최소 3문장 |
+| raw/ 폭발 | 매번 원본 복사 | 프로젝트 내부 문서는 포인터로 |
+| 갱신했는데 log가 비어있음 | 4단계 생략 | ingest 완료 전 log.md 반드시 커밋 |

From 740c463303abc1db6814a0d580fb7f13d12c3815 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:50:42 +0900
Subject: [PATCH 13/21] docs(llm-wiki): port claude-md-block adapted to wiki/
 convention (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../llm-wiki/references/claude-md-block.md    | 32 +++++++++++++++++--
 1 file changed, 29 insertions(+), 3 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/claude-md-block.md b/plugins/documentation/skills/llm-wiki/references/claude-md-block.md
index 57e6f86..de0bb4d 100644
--- a/plugins/documentation/skills/llm-wiki/references/claude-md-block.md
+++ b/plugins/documentation/skills/llm-wiki/references/claude-md-block.md
@@ -1,4 +1,30 @@
-> **Snapshot date**: 2026-04-19
-> **Description**: 사용자 프로젝트 CLAUDE.md에 추가할 LLM Wiki 참조 블록
+## LLM Wiki 활용 규칙
 
-TBD — Stage D에서 작성.
+이 프로젝트는 `wiki/` 디렉토리에 `[[wiki-link]]` 교차참조 위키를 유지한다. Karpathy LLM Wiki 패턴을 따른다.
+
+### 작업 시 우선순위
+
+1. **위키 우선 참조**: 질문에 답하거나 작업을 시작할 때, `wiki/index.md`에서 관련 페이지를 먼저 찾아 읽는다. `[[wiki-link]]`를 따라 2-hop까지 확장하여 맥락을 파악한다.
+2. **출처 인용**: 답변 작성 시 위키 페이지를 `[[페이지 제목]]` 형태로 인용한다.
+3. **위키에 없으면 명시**: 위키에 답이 없으면 "위키에 없음"이라 표기하고 `wiki/raw/` 또는 외부 원본을 읽어 보강한다. 새 내용이면 `llm-wiki ingest`로 위키를 성장시킨다.
+4. **검색보다 컴파일**: 매번 원본을 다시 읽지 말고, 이미 컴파일된 위키 지식을 적극 재활용한다.
+
+### 위키 구조
+
+- `wiki/index.md` — 자동 재빌드되는 라우팅 레이어 (수동 편집 금지)
+- `wiki/{page}.md` — 컴파일된 지식 페이지 (`[[wiki-link]]` 교차참조)
+- `wiki/raw/` — 원본 소스 드롭존 (불변)
+- `wiki/log.md` — ingest 이력
+- `wiki/.lancedb/` — 선택적 벡터 인덱스 (lancedb-sync 실행 시)
+
+### 스킬 명령
+
+사용자가 `llm-wiki <command>`를 호출하면 해당 단계 실행:
+- `init` — 구조 초기화
+- `ingest <source>` — 새 소스를 컴파일해 위키 갱신
+- `query <질문>` — 하이브리드 검색(qmd) 또는 INDEX.md 라우팅
+- `lint` — 끊어진 링크·고아 페이지 탐지
+- `sync` — index.md 재빌드
+- `export <template>` — 온보딩·ADR 요약 등 출력
+- `qmd-index` — qmd 인덱스 빌드 (선택)
+- `lancedb-sync` — LanceDB 벡터 인덱스 동기화 (선택)

From a692bf659580d59290370a72b99e007a38619dd9 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:51:08 +0900
Subject: [PATCH 14/21] docs(llm-wiki): add qmd-integration with install + MCP
 + search modes (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../llm-wiki/references/qmd-integration.md    | 84 ++++++++++++++++++-
 1 file changed, 83 insertions(+), 1 deletion(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/qmd-integration.md b/plugins/documentation/skills/llm-wiki/references/qmd-integration.md
index 9cf1bc0..61ca198 100644
--- a/plugins/documentation/skills/llm-wiki/references/qmd-integration.md
+++ b/plugins/documentation/skills/llm-wiki/references/qmd-integration.md
@@ -1,4 +1,86 @@
 > **Snapshot date**: 2026-04-19
 > **Description**: qmd 설치·컨텍스트 등록·하이브리드 검색 옵션
 
-TBD — Stage D에서 작성.
+# qmd Integration
+
+Karpathy가 LLM Wiki 글에서 검색 백엔드로 추천한 로컬 온디바이스 하이브리드 검색 엔진. BM25 + 벡터 + LLM 재순위를 결합, node-llama-cpp로 완전히 로컬에서 실행. MIT 라이선스.
+
+## 설치
+
+### macOS
+
+```bash
+brew install qmd
+```
+
+### 기타 (Linux, Windows WSL)
+
+```bash
+npm install -g @tobilu/qmd
+```
+
+## Claude Code MCP 연동 (권장)
+
+```bash
+claude marketplace add tobi/qmd
+```
+
+6개 도구 노출: `query`, `search`, `vsearch`, `get`, `multi-get`, `status`. HTTP 데몬 모드에서 LLM 모델이 VRAM에 유지되어 반복 호출 지연 최소화.
+
+## 위키 인덱싱
+
+llm-wiki `qmd-index` 명령이 내부적으로 실행:
+
+```bash
+qmd index wiki/
+qmd context add qmd://wiki "LLM Wiki: 프로젝트 컨텍스트 위키 (Karpathy 패턴)"
+```
+
+수동 실행도 동일. 인덱스는 `~/.qmd/indexes/`에 저장됨 (qmd 기본).
+
+## 검색 모드
+
+| 모드 | CLI | 설명 | 속도 |
+|------|-----|------|------|
+| search | `qmd search "rate limit"` | BM25 키워드 매칭 | ~132ms |
+| vsearch | `qmd vsearch "throttling patterns"` | 벡터 시맨틱 | ~2.9초 |
+| query | `qmd query "API 제한 패턴"` | 하이브리드 (FTS + vec + LLM 재순위) | ~17-20초 |
+
+llm-wiki의 `query` 명령은 내부적으로 `qmd query`를 호출 (qmd 감지 시).
+
+## 다국어 지원
+
+한국어/일본어는 기본 모델(`embeddinggemma-300M`)로도 동작. 품질 향상 원하면:
+
+```bash
+export QMD_EMBED_MODEL=Qwen3-Embedding-0.6B
+qmd index wiki/  # 재인덱싱
+```
+
+## 컨텍스트 트리
+
+qmd의 킬러 피처. 컬렉션별 설명을 추가하면 검색 결과에 컨텍스트가 함께 반환되어 LLM이 문서 위치를 이해:
+
+```bash
+qmd context add qmd://wiki "프로젝트 컨텍스트 위키"
+qmd context add qmd://wiki/decisions "아키텍처 결정 기록 (ADR)"
+qmd context add qmd://wiki/meetings "회의록 요약"
+```
+
+## 스마트 청킹
+
+qmd는 마크다운 헤딩·코드 블록·빈 줄에서 자동 분할, 타겟 ~900 토큰 + 15% 오버랩. 코드 블록은 중간 분할 금지. 별도 설정 불필요.
+
+## lazyqmd (TUI)
+
+Alexander Zeitler의 터미널 UI. Ctrl+T로 search/vsearch/query 모드 전환.
+
+```bash
+bun install -g lazyqmd
+```
+
+## Reference links
+
+- qmd: https://github.com/tobi/qmd
+- lazyqmd: https://github.com/alexanderzeitler/lazyqmd
+- Karpathy LLM Wiki: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

From 4aaadebf4e2197aff552ba8d145f94a755260499 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:51:38 +0900
Subject: [PATCH 15/21] docs(llm-wiki): add lancedb-integration Phase 3
 optional guide (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../references/lancedb-integration.md         | 106 +++++++++++++++++-
 1 file changed, 105 insertions(+), 1 deletion(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md b/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
index e445094..377cd78 100644
--- a/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
+++ b/plugins/documentation/skills/llm-wiki/references/lancedb-integration.md
@@ -1,4 +1,108 @@
 > **Snapshot date**: 2026-04-19
 > **Description**: LanceDB 벡터 인덱스 + Embedding Atlas 연결
 
-TBD — Stage D에서 작성.
+# LanceDB Integration (Phase 3 optional)
+
+> **When to use**: 위키 규모 500페이지 초과, 멀티 에이전트 지식 슬라이싱, Embedding Atlas 시각화 필요 시. 500페이지 미만은 qmd만으로 충분.
+
+## 설치
+
+```bash
+pip install lancedb duckdb sentence-transformers
+```
+
+임베딩 모델:
+- 기본 `all-MiniLM-L6-v2` — CPU에서 빠름, 영어 중심
+- 한국어·다국어 `Qwen3-Embedding-0.6B` — MMTEB 70.58점, 프로덕션 품질
+
+## 인덱스 생성
+
+```bash
+./scripts/lancedb_sync.py --wiki-dir ./wiki --model all-MiniLM-L6-v2
+```
+
+결과:
+- `wiki/.lancedb/` 디렉토리에 `.lance` 파일 생성
+- `wiki/.gitignore` 기본적으로 `.lancedb/` 제외 (init.sh에서 자동)
+
+## Embedding Atlas 연결
+
+```bash
+pip install embedding-atlas
+atlas open wiki/.lancedb/
+```
+
+브라우저에서 WebGPU 렌더링으로 수백만 포인트 가시화. 멀티 코디네이트 뷰 교차 필터링. MCP 지원으로 Claude Code 직접 연동 가능.
+
+## DuckDB SQL 분석
+
+LanceDB는 Lance extension for DuckDB를 통해 DuckDB와 네이티브 통합. 데이터 변환 제로:
+
+```
+LanceDB (.lance files)
+    ↕  Lance extension
+DuckDB (shared query engine)
+    ↕  Mosaic coordinator
+Apple Embedding Atlas (WebGPU visualization)
+```
+
+분석 쿼리 예:
+
+```sql
+-- 지난 7일 미업데이트 페이지
+SELECT path, title, updated
+FROM lance_scan('wiki/.lancedb/wiki_pages.lance')
+WHERE updated < CURRENT_DATE - INTERVAL '7 days'
+ORDER BY updated ASC;
+
+-- 카테고리별 페이지 수
+SELECT type, COUNT(*) as n
+FROM lance_scan('wiki/.lancedb/wiki_pages.lance')
+GROUP BY type
+ORDER BY n DESC;
+
+-- 낮은 confidence 페이지
+SELECT path, title, confidence
+FROM lance_scan('wiki/.lancedb/wiki_pages.lance')
+WHERE confidence IN ('low', 'tentative');
+```
+
+## 트레이드오프 (report §6.2 요약)
+
+**장점**:
+- 시맨틱 디스커버리 (이름을 모르는 관련 개념도 찾음)
+- 멀티 에이전트 슬라이싱 (`WHERE project = 'X'` 필터)
+- Embedding Atlas로 지식 맵 시각화
+- Lance 포맷 자동 버전 관리가 위키 편집 히스토리와 정합
+- DuckDB SQL로 분석 쿼리 바로 실행
+
+**단점**:
+- 복잡도 비용 (임베딩 모델, 청킹, 인덱스 동기화)
+- 듀얼 소스 오브 트루스 (md ↔ vec) — 동기화 지연
+- 임베딩 모델 lock-in (모델 바꾸면 전체 재인덱싱)
+- LanceDB v0.23.x 베타 상태
+- qmd가 이미 거의 같은 검색 문제를 해결
+
+## qmd vs LanceDB
+
+qmd는 BM25 + vector + LLM 재순위를 이미 결합하고 MCP로 에이전트 통합. 설치 zero-dep. 대부분의 경우 qmd만으로 충분.
+
+LanceDB는 다음 요구가 있을 때 추가:
+- 500페이지 초과 대규모 위키
+- 멀티 프로젝트 에이전트 슬라이싱
+- 시각화·SQL 분석·커스텀 랭커 필요
+
+## 단계별 채택
+
+| Phase | 규모 | 전략 |
+|-------|------|------|
+| 1 | <100 페이지 | 벡터 DB 없이 Karpathy 원본 |
+| 2 | 100~500 페이지 | qmd 하이브리드만 |
+| 3 | 500+ 페이지 | qmd + LanceDB + Embedding Atlas |
+
+## Reference links
+
+- LanceDB: https://lancedb.com
+- Lance DuckDB extension: https://github.com/lancedb/lance-duckdb
+- Apple Embedding Atlas: https://github.com/apple/embedding-atlas
+- Anthropic Contextual Retrieval: https://anthropic.com/news/contextual-retrieval

From a502859c251711bcbbdb06767c8a9988bbfa1941 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:52:16 +0900
Subject: [PATCH 16/21] docs(llm-wiki): add karpathy-pattern origin and design
 decisions (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../llm-wiki/references/karpathy-pattern.md   | 75 ++++++++++++++++++-
 1 file changed, 74 insertions(+), 1 deletion(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md b/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
index 4426ebd..d46fa58 100644
--- a/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
+++ b/plugins/documentation/skills/llm-wiki/references/karpathy-pattern.md
@@ -1,4 +1,77 @@
 > **Snapshot date**: 2026-04-19
+> **Source**: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
 > **Description**: Karpathy 원본 패턴 요약 및 본 구현 결정 기록
 
-TBD — Stage D에서 작성.
+# Karpathy LLM Wiki 패턴
+
+## 핵심 아이디어
+
+> RAG는 무상태. Wiki는 복리로 축적된다.
+
+대부분의 LLM 작업은 RAG로 매번 처음부터 지식을 재발견한다. LLM Wiki는 달리, 지속적으로 상호 연결된 지식 베이스를 **증분 구축**한다. 교차 참조가 이미 존재하고, 모순이 이미 플래그되며, 합성 결과가 이전에 수집된 모든 것을 반영한다.
+
+Andrej Karpathy가 2026년 4월 3~4일 X 포스트와 GitHub gist로 발표. 수일 내 5,000+ 스타, 3,600+ 포크.
+
+## 3계층 아키텍처
+
+- `raw/` — 불변 입력 문서 (LLM이 읽기만, 수정 금지)
+- `wiki/*.md` — LLM이 생성·유지하는 마크다운 (요약, 엔티티 페이지, 개념 비교, 마스터 인덱스)
+- `CLAUDE.md` — 스키마·컨벤션 (위키 구조 정의, 워크플로 지시)
+
+## 3가지 핵심 연산
+
+| 연산 | 설명 |
+|------|------|
+| Ingest | 소스를 넣으면 LLM이 10~15개 위키 페이지를 업데이트 |
+| Query | LLM이 인덱스를 검색하고 답변을 합성 |
+| Lint | 주기적 건강 점검 — 모순, 부실 주장, 고아 페이지 탐지 |
+
+## 본 구현의 확장 결정
+
+### 1. `wiki/` 노출형 선택
+
+Karpathy 원본은 디렉토리 이름을 엄격히 규정하지 않는다. 본 구현은 워크스페이스 CLAUDE.md의 "LLM Wiki 활용 규칙"이 `wiki/index.md` 존재를 시그널로 쓰도록 규정하므로 노출형 `wiki/`를 채택. Obsidian에서 vault로 직접 열 수 있는 이점도 있다.
+
+### 2. 명령 8개로 확장
+
+Karpathy 원본 3개(Ingest/Query/Lint) + 본 구현 추가 5개:
+- `init` — 구조 자동 생성 (Karpathy는 수동 설명만)
+- `sync` — `index.md` 결정론적 재빌드 (LLM 오류 방지)
+- `export` — 온보딩/ADR/릴리스 노트 템플릿 출력
+- `qmd-index` — 하이브리드 검색 백엔드 설정
+- `lancedb-sync` — Phase 3 벡터 인덱스
+
+### 3. qmd 통합 (Karpathy 권장)
+
+Karpathy가 LLM Wiki 글에서 qmd를 명시적으로 추천. 본 구현은 qmd 설치 감지 시 자동으로 하이브리드 검색으로 승격, 미설치 시 INDEX.md 라우팅으로 graceful degrade.
+
+### 4. LanceDB는 선택적
+
+Karpathy는 벡터 DB를 명시적으로 배제했다. 이유: 잘 큐레이션된 INDEX.md + LLM 컨텍스트 윈도우가 개인 규모 위키에는 충분. 본 구현도 이 원칙을 존중하여 500페이지 초과 또는 멀티 에이전트 시나리오에서만 권장.
+
+### 5. Obsidian 호환 (`[[wiki-link]]`)
+
+표준 Obsidian 링크 형식을 채택. 사용자가 `wiki/`를 Obsidian vault로 열면:
+- 그래프 뷰로 교차 참조 시각화
+- 네이티브 링크 follow
+- 마크다운 실시간 프리뷰
+- 백링크 자동 추적
+
+## 규모별 전략
+
+| 규모 | 전략 |
+|------|------|
+| <100 페이지 | Karpathy 원본 (INDEX.md + LLM 컨텍스트 윈도우만) |
+| 100~500 페이지 | qmd 하이브리드 검색 활용 |
+| 500+ 페이지 | LanceDB + DuckDB + Embedding Atlas 추가 |
+
+규모 성장에 따라 단계적으로 추가할 수 있도록 설계됨. Phase 1 사용자가 Phase 2로 업그레이드하려면 `qmd install` + `llm-wiki qmd-index` 한 번만 실행하면 된다.
+
+## 참고
+
+- Karpathy 원문: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f
+- Karpathy 트윗: https://x.com/karpathy/status/2039805659525644595
+- 기존 LLM Wiki 구현 사례:
+  - `github.com/tinworks-ai/claude-obsidian` (358+ 스타, 8-카테고리 린트)
+  - `github.com/llm-wiki/kb-wiki` (npm 패키지, MCP 네이티브)
+  - `github.com/khoj-ai/khoj` (25K+ 스타, 오픈소스 세컨드 브레인)

From 8ae61efbb259502e80133a88a1f80d9446afc38e Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:55:27 +0900
Subject: [PATCH 17/21] feat(llm-wiki): write 8-command orchestrator SKILL.md
 (#8)

Preserves frontmatter from scaffold (Stage B). Body documents 8 commands,
graceful degrade, integration points with qa-merge/intent/korean-docs,
and anti-patterns. Progressive disclosure via 6 references/.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../documentation/skills/llm-wiki/SKILL.md    | 181 +++++++++++++++++-
 1 file changed, 179 insertions(+), 2 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/SKILL.md b/plugins/documentation/skills/llm-wiki/SKILL.md
index aac6640..b87111c 100644
--- a/plugins/documentation/skills/llm-wiki/SKILL.md
+++ b/plugins/documentation/skills/llm-wiki/SKILL.md
@@ -4,6 +4,183 @@ description: Karpathy LLM Wiki 패턴 구현. 프로젝트 문서(스펙/ADR/회
 argument-hint: "[init|ingest|query|lint|sync|export|qmd-index|lancedb-sync] [args]"
 ---
 
-# llm-wiki
+# llm-wiki — 프로젝트 컨텍스트 위키
 
-스캐폴드 상태 — 본문은 Stage E에서 작성.
+> 참고: [Karpathy LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f).
+> **검색이 아닌 컴파일**이 핵심 — 한 번 이해한 것은 계속 다듬어 재활용한다.
+
+## 언제 사용하나
+
+트리거: "위키 초기화", "wiki 초기화", "wiki ingest", "문서 wiki로 정리", "프로젝트 컨텍스트 위키", "llm wiki", "knowledge base 구축", "wiki query", "서드파티 소스 컴파일".
+
+이 스킬은 워크스페이스 CLAUDE.md의 **"LLM Wiki 활용 규칙"을 실제 실행 가능하게** 한다.
+
+## 디렉토리 구조
+
+프로젝트 루트에 `init` 명령으로 생성되는 구조:
+
+```text
+wiki/
+├── index.md              # 자동 재빌드 (수동 편집 금지)
+├── log.md                # ingest 이력
+├── raw/                  # 원본 소스 드롭존 (불변)
+│   └── YYYY-MM-DD_{source}.md
+├── {page}.md             # 컴파일된 위키 페이지 ([[wiki-link]] 교차참조)
+├── .gitignore            # raw/private/, .lancedb/ 기본 제외
+└── .lancedb/             # 선택적 벡터 인덱스 (lancedb-sync 시)
+```
+
+프로젝트 루트 `CLAUDE.md`에는 "LLM Wiki 활용 규칙" 블록이 `init` 시 자동 추가된다.
+
+## 페이지 프론트매터 규약
+
+```yaml
+---
+title: "Rate Limiter Design"
+type: decision          # concept | decision | entity | meeting | policy | comparison
+tags: [api, reliability]
+status: active          # draft | active | stale | archived
+confidence: high        # high | medium | low | tentative
+created: 2026-04-19
+updated: 2026-04-19
+sources: [raw/2026-04-18_arch-review.md]
+---
+```
+
+상세는 [page-templates.md](references/page-templates.md) 참조.
+
+## 8개 명령
+
+### `init` — 구조 초기화
+
+**실행**: `scripts/init.sh [project-root]`
+
+- `wiki/` 디렉토리 구조 생성 (`raw/` 포함)
+- `wiki/index.md`, `log.md`, `.gitignore` 초기 파일
+- 프로젝트 루트 `CLAUDE.md`에 LLM Wiki 블록 추가 ([claude-md-block.md](references/claude-md-block.md))
+- qmd / LanceDB 환경 감지 및 설치 안내
+
+### `ingest <source>` — 소스 컴파일
+
+**실행**: LLM 주도 워크플로 (스크립트 없음)
+
+상세 5단계: [ingest-workflow.md](references/ingest-workflow.md)
+
+1. 소스 읽기 (`raw/`에 드롭된 파일 또는 인자 경로)
+2. 엔티티·개념 추출
+3. 기존 wiki 페이지와 교차 참조 검토
+4. 페이지 생성/갱신 (10-15 페이지)
+5. `log.md`에 기록
+
+페이지 유형 선택은 [page-templates.md](references/page-templates.md) 6종(concept/decision/entity/meeting/policy/comparison) 참조.
+
+### `query <질문>` — 위키 검색
+
+**qmd 감지 시 (하이브리드 검색)**:
+1. `qmd query "<질문>"` 호출
+2. BM25 + 벡터 + LLM 재순위 결과 top-10
+3. LLM이 컨텍스트 트리 + 매칭 페이지로 답변 합성
+4. 답변에 `[[wiki-link]]`로 출처 인용
+
+**qmd 미감지 시 (graceful degrade — INDEX.md 라우팅)**:
+1. `wiki/index.md` 읽어 관련 페이지 후보 3-5개 식별
+2. 후보 페이지 본문 로드 + `[[link]]` 2-hop 확장
+3. LLM이 로드된 컨텍스트로 답변
+4. "qmd 미설치 — 하이브리드 검색 원하면 `brew install qmd`" 안내 첨부
+
+qmd 설정·MCP 연동: [qmd-integration.md](references/qmd-integration.md).
+
+### `lint` — 건강 점검
+
+**실행**: `scripts/lint_wiki.py [--wiki-dir PATH]`
+
+검사 항목:
+- 끊어진 `[[wiki-link]]`
+- 고아 페이지 (어디에서도 참조되지 않음)
+- frontmatter 필수 필드 누락 (`title`, `updated`)
+- `confidence: low` 또는 `tentative` 페이지 플래그
+
+Exit code: 0 = clean, 1 = issues found.
+
+### `sync` — index.md 재빌드
+
+**실행**: `scripts/sync_index.py [--wiki-dir PATH]`
+
+`wiki/*.md` 스캔 → frontmatter `type` 별로 그룹화 → `index.md` 재생성. 수동 편집은 덮어씌워지므로 index에는 내용을 쓰지 말 것.
+
+### `export <template>` — 템플릿 출력
+
+**실행**: LLM 주도 워크플로
+
+지원 템플릿:
+- `onboarding` — 신규 팀원 온보딩 가이드
+- `adr-summary` — decision 유형 페이지 목록 + 요약
+- `release-notes` — 지정 기간의 변경 페이지 요약
+- `qa-export` — 축적된 지식을 별도 Q&A 문서로
+
+### `qmd-index` — qmd 인덱스 (선택)
+
+**실행**: `scripts/qmd_index.sh [wiki-dir]`
+
+qmd 설치 전제. 없으면 설치 안내 후 exit 1:
+- macOS: `brew install qmd`
+- 기타: `npm install -g @tobilu/qmd`
+
+내부적으로 `qmd index wiki/` + `qmd context add` 실행. Claude Code MCP 통합은 [qmd-integration.md](references/qmd-integration.md).
+
+### `lancedb-sync` — LanceDB 벡터 인덱스 (선택)
+
+**실행**: `scripts/lancedb_sync.py [--wiki-dir PATH] [--model MODEL]`
+
+Phase 3 옵션. `pip install lancedb duckdb sentence-transformers` 전제. 없으면 설치 안내 후 exit 1.
+
+상세·SQL 쿼리 예·Embedding Atlas 연결: [lancedb-integration.md](references/lancedb-integration.md).
+
+## Graceful Degrade 원칙
+
+- `query`는 항상 작동 (qmd 있으면 하이브리드, 없으면 INDEX.md 라우팅으로 degrade)
+- 명시 명령(`qmd-index`, `lancedb-sync`)은 의존성 없으면 설치 안내 + exit 1
+- `init`은 환경 감지만 할 뿐 종료 코드에 영향 없음
+
+## 통합 포인트
+
+### 다른 스킬과의 관계
+
+- **`qa-merge`**: Q&A 카드 통합 결과를 `wiki/raw/`에 드롭 → 자동 ingest 대상. Q&A 축적 → 위키 컴파일 파이프라인.
+- **`intent`**: `INTENT.md` 변경 시 `wiki/raw/`로 복사 후 ingest → Why/What/Not/Learnings가 decision·entity 페이지로 분해.
+- **`korean-docs`**: 한국어 출력 규칙과 직교. 위키 페이지 식별자는 영어 허용 (Obsidian 호환).
+
+### Obsidian
+
+`wiki/`를 Obsidian vault로 열면:
+- 그래프 뷰로 교차 참조 시각화
+- `[[wiki-link]]` 네이티브 네비게이션
+- 마크다운 실시간 프리뷰
+- 백링크 자동 추적
+
+## Karpathy 원칙 준수
+
+- `raw/`는 LLM이 수정하지 않음 (read-only for wiki purposes)
+- `wiki/*.md`는 LLM이 증분 갱신 (컴파일)
+- CLAUDE.md가 스키마·컨벤션을 정의
+- 3가지 연산(Ingest/Query/Lint)이 핵심, 나머지는 보조
+
+원본 설계 결정 기록: [karpathy-pattern.md](references/karpathy-pattern.md).
+
+## References (Progressive Disclosure)
+
+- [page-templates.md](references/page-templates.md) — 6개 페이지 유형 템플릿
+- [ingest-workflow.md](references/ingest-workflow.md) — Ingest 5단계 상세
+- [claude-md-block.md](references/claude-md-block.md) — CLAUDE.md 추가 블록 템플릿
+- [qmd-integration.md](references/qmd-integration.md) — qmd 설치·설정·MCP
+- [lancedb-integration.md](references/lancedb-integration.md) — LanceDB + Embedding Atlas (Phase 3)
+- [karpathy-pattern.md](references/karpathy-pattern.md) — 원본 패턴 + 본 구현 결정 기록
+
+## Anti-patterns
+
+- `wiki/index.md` 수동 편집 (sync에 덮어씌워짐 — 내용은 페이지에)
+- `wiki/raw/`의 원본 수정 (불변 원칙 위반 — 새 버전을 새 파일로 드롭)
+- 페이지 제목에 한국어 공백 (Obsidian `[[link]]` 호환성 저하 — slug는 영어/하이픈 권장)
+- 모순되는 정보를 두 페이지에 분산 (합성하여 단일 페이지로 정리하는 것이 위키의 목적)
+- `lint` 미실행 상태로 장기 방치 (고아·끊어진 링크 누적)
+- 벡터 DB 과잉 도입 (500페이지 미만은 qmd만으로 충분)

From 13eb34aca2e7ec630bd3d7f4556b320b3d0252ab Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:56:25 +0900
Subject: [PATCH 18/21] docs(readme): list llm-wiki skill in Documentation
 section (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 89ae319..f578a78 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,7 @@ Git 워크플로우 및 협업 관련
 | [qa](plugins/documentation/skills/qa) | 기술/수학적 개념 Q&A 기록 |
 | [qa-list](plugins/documentation/skills/qa-list) | 저장된 Q&A 문서 목록 표시 |
 | [qa-merge](plugins/documentation/skills/qa-merge) | Q&A 문서를 통합 레퍼런스로 병합 |
+| [llm-wiki](plugins/documentation/skills/llm-wiki) | Karpathy LLM Wiki 패턴 - 프로젝트 문서를 컴파일 위키로 유지 (qmd 하이브리드 검색, Obsidian 호환) |
 
 ### Memory
 

From 5645ac8967c725d4c8bf946acddb38d8c5e5b25c Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:56:50 +0900
Subject: [PATCH 19/21] docs(documentation): add llm-wiki to plugin README (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 plugins/documentation/README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/plugins/documentation/README.md b/plugins/documentation/README.md
index 56ab0ca..b5a88bf 100644
--- a/plugins/documentation/README.md
+++ b/plugins/documentation/README.md
@@ -8,6 +8,7 @@
 - **Q&A 기반 지식 축적** — `qa`, `qa-list`, `qa-merge`의 3-스킬 파이프라인으로 개별 질문·답변을 문서화·검색·병합 가능한 지식 자산으로 발전시킵니다.
 - **구조화된 Q&A 관리** — 개별 Q&A 카드 → 리스트 뷰 → 병합된 통합 레퍼런스까지 단계적으로 진화시키는 파이프라인을 제공합니다.
 - **국내 개발팀 지향** — 한국어 문서화와 Q&A 워크플로가 결합되어 한국어 기반 팀의 문서 자산화에 최적입니다.
+- **지식 컴파일** — `llm-wiki`가 Karpathy LLM Wiki 패턴으로 프로젝트 문서를 `wiki/`에 교차참조 마크다운으로 컴파일합니다. RAG 재검색이 아닌 복리 축적 모델. qmd 하이브리드 검색 자동 활성, LanceDB + Embedding Atlas 선택적.
 
 ## 수록 스킬
 
@@ -17,6 +18,7 @@
 | [qa](skills/qa) | 기술·수학·도메인 개념 Q&A를 구조화된 문서로 기록 | "이 개념 Q&A로 저장해줘", "/qa 트랜잭션 격리 수준" |
 | [qa-list](skills/qa-list) | 저장된 Q&A 문서 목록 표시 (카테고리 필터 가능) | "저장된 Q&A 보여줘", "/qa-list" |
 | [qa-merge](skills/qa-merge) | 개별 Q&A 문서들을 하나의 통합 레퍼런스 문서로 병합 | "Q&A 병합해서 레퍼런스 만들어줘", "/qa-merge" |
+| [llm-wiki](skills/llm-wiki) | Karpathy LLM Wiki 패턴으로 프로젝트 문서를 컴파일 위키로 유지 | "위키 초기화", "wiki ingest", "프로젝트 컨텍스트 위키", "knowledge base 구축" |
 
 ## 사용 예시
 
@@ -29,6 +31,9 @@
 ### 예시 3 — 쌓인 Q&A를 통합 레퍼런스로 병합
 분기별 혹은 토픽별로 `/qa-merge`를 실행하면 여러 개의 Q&A 카드가 하나의 통합 문서로 합쳐져 팀 위키나 온보딩 자료로 바로 사용 가능합니다.
 
+### 예시 4 — 프로젝트 지식을 위키로 컴파일
+`llm-wiki init`으로 `wiki/` 구조를 생성하고 기존 문서(스펙·ADR·회의록)를 `wiki/raw/`에 드롭한 뒤 `llm-wiki ingest`로 컴파일합니다. qmd 설치 시 하이브리드 검색이, LanceDB 설치 시 벡터 시각화(Embedding Atlas)가 자동 활성됩니다. 이후 `query`·`lint`·`sync`·`export`로 지식을 유지·활용합니다.
+
 ## 설치
 
 ```bash

From 662a9077c7ae336cf092e9f29a5a787328922707 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 15:57:03 +0900
Subject: [PATCH 20/21] docs(changelog): note llm-wiki skill (#8)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 156e17b..106b233 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **serverless-migration-advisor** (workflow): AWS always-on 아키텍처를 서버리스+Spot 패턴으로 이행할 때 사용하는 업스트림 어드바이저. 5-Phase 인터뷰 → 타겟 아키텍처 매핑 → 단계별 체크리스트 리포트 생성. AWS Docs 인용 의무 + serverless-autoresearch($3.94/48실험) 및 serverless-openclaw($1/월) 검증 사례 인용. 구현 how-to는 `sagemaker-spot-training` 등으로 위임. (#3)
 - development 플러그인에 `sagemaker-spot-training` 스킬 등록 (marketplace.json + plugins/development/README.md). `serverless-migration-advisor`의 Delegation 타겟으로 참조되는 스킬을 실제 설치 가능 상태로 전환. (#5)
+- **llm-wiki** (documentation): Karpathy LLM Wiki 패턴 구현 스킬. 8개 서브커맨드(init/ingest/query/lint/sync/export/qmd-index/lancedb-sync). qmd 설치 시 하이브리드 검색 자동 활성, 미설치 시 INDEX.md 라우팅으로 graceful degrade. LanceDB + Embedding Atlas 선택적 벡터 인덱스 지원. Obsidian 호환 `[[wiki-link]]`. 워크스페이스 CLAUDE.md "LLM Wiki 활용 규칙"과 통합. (#8)
 
 ### Changed
 

From f6447c9dc3faebc9f398e0dcd422805482867652 Mon Sep 17 00:00:00 2001
From: Jung Do Hyun <serithemage@gmail.com>
Date: Sun, 19 Apr 2026 16:19:52 +0900
Subject: [PATCH 21/21] =?UTF-8?q?fix(llm-wiki):=20address=20PR=20#9=20revi?=
 =?UTF-8?q?ew=20issues=20=E2=80=94=20orphan=20detection,=20CLAUDE.md=20H1,?=
 =?UTF-8?q?=20doc=20paths=20(#8)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- lint_wiki.py: exclude index.md/log.md from 'referenced' set so orphan
  detection actually works after sync (previously sync auto-linked every
  page from index.md, nullifying orphan detection).
- init.sh: prepend H1 "# CLAUDE.md" when creating a fresh CLAUDE.md.
- ingest-workflow.md: correct script invocation paths to relative form.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../llm-wiki/references/ingest-workflow.md    |  6 ++--
 .../skills/llm-wiki/scripts/init.sh           |  8 ++++-
 .../skills/llm-wiki/scripts/lint_wiki.py      | 33 ++++++++-----------
 3 files changed, 25 insertions(+), 22 deletions(-)

diff --git a/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md b/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
index f452b6d..f96a795 100644
--- a/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
+++ b/plugins/documentation/skills/llm-wiki/references/ingest-workflow.md
@@ -88,9 +88,11 @@
 
 순서대로 실행:
 
+> 참고: 아래 명령은 스킬이 내부적으로 호출하는 경로로, 사용자가 직접 실행할 일은 드뭅니다. 스킬 설치 경로에 따라 실제 경로는 다를 수 있습니다.
+
 ```bash
-python .claude/skills/llm-wiki/scripts/sync_index.py
-python .claude/skills/llm-wiki/scripts/lint_wiki.py
+python scripts/sync_index.py
+python scripts/lint_wiki.py
 ```
 
 **결과 처리:**
diff --git a/plugins/documentation/skills/llm-wiki/scripts/init.sh b/plugins/documentation/skills/llm-wiki/scripts/init.sh
index db7e845..3c30137 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/init.sh
+++ b/plugins/documentation/skills/llm-wiki/scripts/init.sh
@@ -60,7 +60,13 @@ if [ -f "$CLAUDE_MD" ]; then
   fi
 else
   if [ -f "$CLAUDE_BLOCK_TPL" ]; then
-    cat "$CLAUDE_BLOCK_TPL" > "$CLAUDE_MD"
+    {
+      echo "# CLAUDE.md"
+      echo ""
+      echo "This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository."
+      echo ""
+      cat "$CLAUDE_BLOCK_TPL"
+    } > "$CLAUDE_MD"
     echo "  ✓ CLAUDE.md 생성"
   else
     echo "  ⚠ CLAUDE.md 블록 템플릿 미존재 — CLAUDE.md 생성 건너뜀"
diff --git a/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py b/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
index d84006f..8941c4e 100755
--- a/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
+++ b/plugins/documentation/skills/llm-wiki/scripts/lint_wiki.py
@@ -54,38 +54,33 @@ def lint(wiki_dir):
 
     for md in md_files:
         text = md.read_text(encoding='utf-8')
+        is_index_or_log = md.name in ('index.md', 'log.md')
 
-        if md.name in ('index.md', 'log.md'):
-            for link in WIKILINK_RE.findall(text):
-                referenced.add(link.strip())
-                target = link.strip()
-                if target not in page_stems:
+        if not is_index_or_log:
+            fm = parse_frontmatter(text)
+
+            for field in REQUIRED_FM:
+                if field not in fm or not fm[field]:
                     issues.append(
-                        f"{md.relative_to(wiki_dir)}: broken link [[{target}]]"
+                        f"{md.relative_to(wiki_dir)}: frontmatter `{field}` missing"
                     )
-            continue
 
-        fm = parse_frontmatter(text)
-
-        for field in REQUIRED_FM:
-            if field not in fm or not fm[field]:
+            confidence_raw = fm.get('confidence', '')
+            confidence = confidence_raw.lower() if isinstance(confidence_raw, str) else ''
+            if confidence in ('low', 'tentative'):
                 issues.append(
-                    f"{md.relative_to(wiki_dir)}: frontmatter `{field}` missing"
+                    f"{md.relative_to(wiki_dir)}: low-confidence page flagged"
                 )
 
-        confidence = fm.get('confidence', '').lower() if isinstance(fm.get('confidence', ''), str) else ''
-        if confidence in ('low', 'tentative'):
-            issues.append(
-                f"{md.relative_to(wiki_dir)}: low-confidence page flagged"
-            )
-
         for link in WIKILINK_RE.findall(text):
             target = link.strip()
-            referenced.add(target)
             if target not in page_stems:
                 issues.append(
                     f"{md.relative_to(wiki_dir)}: broken link [[{target}]]"
                 )
+            elif not is_index_or_log:
+                # Only count references from content pages toward orphan detection
+                referenced.add(target)
 
     orphans = page_stems - referenced
     for orphan in sorted(orphans):