llm-wiki

Files (8)

• SKILL.md
• lint-rules.md · references/
• obsidian-compat.md · references/
• output-formats.md · references/
• source-types.md · references/
• build_graph.py · scripts/
• fetch_web.py · scripts/
• transcribe.py · scripts/

SKILL.md (first lines)

# /llm-wiki — Karpathy LLM Wiki (범용)

> **단일 출처(SSoT)**: schema 사양은 `~/.claude/skills/_wiki-schema.md` 와 호환되지만,
> 본 스킬은 jira 도메인을 가정하지 않는 **범용 wiki** 를 다룬다.
> jira/dev-guide 워크플로우는 `jira-ingest` + `wiki-lint` 사용.

## 핵심 아이디어 (Karpathy 2026-04 gist 원형)

```
raw/         <- 원본 소스 (PDF/오디오/HTML/이미지/텍스트 — 절대 손대지 않음)
  ↓ ingest (build-time 합성 — LLM 이 읽고 구조화)
wiki/        <- 정제된 노트 (entities / concepts / sources / questions / syntheses)
  ↑ query (이미 합성된 노트에서 검색·재구성 — build-time 비용 분할상환)
CLAUDE.md / AGENTS.md  <- wiki 메타 (디렉토리 구조, 작성 규약, 명명 룰)
```

핵심 원칙:
1. **Wiki ≠ RAG**: RAG 는 query-time 합성(매번 처음부터), Wiki 는 build-time 합성(한 번만, 영구 자산).
2. **원본 보존**: `raw/` 의 파일은 절대 수정·삭제하지 않는다. 사람이 직접 정리할 때만 (수동 archive).
3. **점진적 합성**: 한 번에 완벽한 위키를 만들지 않는다. 흡수 → 인덱스 → 점진 보강.
4. **그래프 구조**: 노트끼리 wikilink(`[[Other Note]]`) 로 연결. Concept ↔ Source ↔ Question 그래프.
5. **Lint loop**: 주기적 자체 검토 (contradictions / stale / orphans / missing concepts / broken xref / data gaps).

## Usage

```
사용자 입력 예 (자연어 — 모드 자동 추론):

# ingest 모드
"https://example.com/article 위키에 넣어줘"
"이 PDF 정리해줘: ~/Downloads/paper.pdf"
"방금 들은 팟캐스트 받아써서 위키화" (+ 오디오 파일 경로)
"슬랙 #design 스레드 4월 12일자 위키에"

# query 모드
"내 위키에서 'mixture of experts' 찾아줘"
"transformer attention 관련 노트 표로 보여줘"
"이 주제로 슬라이드 만들어줘 — wiki 기반"

# lint 모드
"내 wiki stale 한 거 있는지 봐줘"
"위키 정합성 점검"
"orphan 노트 찾아"
```

명시적 플래그는 **하나도 없다** — 모든 동작은 입력 의도 추론. (※ jira-ingest 의 `--subtasks` 와 다름.)

## ⛔ Guard — 첫 실행 / 위치 결정 (최우선)

이 스킬의 어떤 단계보다 **먼저** 실행한다.

### 1단계: WIKI_ROOT 결정

**입력에 명시 경로가 있으면** (`~/wiki/`, `/Volumes/Notes/`, `D:/Obsidian/Vault/` 등):
- 그 경로를 사용. 없으면 생성 확인.

**없으면 후보 자동 탐색** (우선순위):
1. 현재 작업 디렉토리의 `wiki/`, `notes/`, `vault/`
2. `~/wiki/`, `~/notes/`, `~/Documents/wiki/`, `~/Obsidian/`
3. 환경변수 `WIKI_ROOT` / `OBSIDIAN_VAULT`

발견되면 사용자에게 확인:
```
🔍 위키 후보 발견: ~/wiki/ (이전 생성 흔적 — CLAUDE.md + raw/ 존재)
이 위치 사용? [Y/n] / 다른 경로 입력
```

**아무것도 없으면 → 첫 실행 (§1 Onboarding)**.

### 2단계: 의도 분류 (intent inference)

사용자 입력 + 컨텍스트 (전달된 파일 / URL / 키워드) 보고 분류:

| 입력 단서 | 모드 |
|----------|------|
| URL / 파일 경로 / "넣어줘 / 정리 / 저장 / 추가" | **ingest** |
| "찾아줘 / 알려줘 / 어디 / 표로 / 슬라이드 / 차트" | **query** |
| "점검 / 정합성 / lint / stale / orphan / 중복" | **lint** |
| 애매하면 → 사용자에게 1줄 확인 | (default ingest) |

---

## §1. 첫 실행 / Onboarding

WIKI_ROOT 가 비어있거나 `CLAUDE.md` + `raw/` 구조가 없으면 진입.

### 1.1 위치 합의

```
📓 LLM Wiki 첫 셋업이군요.

추천 경로:
  A. ~/wiki/          (가장 간단)
  B. ~/Documents/wiki/ (다른 문서와 함께)
  C. ~/Obsidian/MyVault/ (Obsidian 호환 — 그래프뷰/플러그인 사용)
  D. <사용자 지정>

어디로 할까요?
```

### 1.2 기본 디렉토리 생성

```
<WIKI_ROOT>/
├── CLAUDE.md           # wiki 자체 메타 (이 파일)
├── raw/                # 원본 소스 (immutable)
│   ├── articles/
│   ├── pdfs/
│   ├── audio/
│   ├── images/
│   ├── threads/        # 슬랙/이메일/포럼 dump
│   └── notes/          # 직접 작성한 raw notes
├── wiki/               # 합성된 노트
│   ├── entities/       # 인물 / 조직 / 제품 (고유명사)
│   ├── concepts/       # 추상 개념 / 기법 / 패턴
│   ├── sources/        # 원본 1:1 매칭 source-card
│   ├── questions/      # 미해결 질문 / open loop
│   └── syntheses/      # 여러 노트를 묶는 longer-form 정리
├── INDEX.md            # grep-first 평탄 인덱스 (전체 노트 1줄/개)

From bigbulgogiburger/claude_jira_harness, MIT.

More from bigbulgogiburger/claude_jira_harness