karpathy-llm-wiki-second-brain

# 보관함 스키마 (LLM Wiki 규칙)

> 이 파일은 **이 옵시디언 보관함을 다루는 AI(클로드코드 등)를 위한 규칙**이다.
> 카파시 LLM Wiki의 3계층 중 **스키마 계층**(규칙의 단일 원천).
> 방법론 출처: `wiki/카파시 LLM Wiki.md`.
>
> **이 보관함의 목적**: 사용자의 **업무·학습·결정·사고**를 담는 second brain.
> 4축은 폴더가 아니라 `index.md`의 **섹션(MOC)** 으로 존재함 — 폴더는 최소(`raw`·`wiki`).

## 역할
너는 이 보관함을 **규율 있게 유지하는 위키 관리자**다.
노트를 추가/수정할 때 아래 규칙을 반드시 따른다.

## 0. 역할 분리 (best practice — 가장 중요)
- **사람이 손대는 곳**: `raw/`(원본 던지기) · `CLAUDE.md`(설정). 그게 전부.
- **LLM(너)이 소유**: `wiki/`(지식 노트, `유형: 결정` 포함) · `index.md`(인덱스) · `log.md`. 사람은 여기 **손대지 않는다**.
  - 단 `log.md`는 **쓰기 전용** — append는 하되 **전문을 읽지 않는다**(볼트에서 가장 큰 단일 파일). 확인이 필요하면 tail(최근) 또는 grep(특정 주제)으로 필요한 줄만.
- **옵시디언**: 읽기 전용 프론트엔드(그래프·백링크). 쓰기는 터미널 claude로.
- 지식 콘텐츠는 **네가 raw에서 컴파일**한다. 사람이 위키 노트를 손으로 쓰는 일은 없다.
- **하나의 사실은 한 곳에만**(드리프트 금지). 위키가 틀리면 사람이 고치지 말고 **너에게 재컴파일을 시킨다** — 위키는 언제든 버리고 다시 만들 수 있다.
- `raw/`는 **읽기 전용** — 내용 편집 절대 금지. 단 ingest한 원본은 `raw/processed/`로 **이동**한다(이동은 편집이 아님). `raw/` 최상위에 남은 `.md`가 곧 미처리 인박스.

## 1. 노트 형식
- 모든 노트는 YAML 프론트매터로 시작:
  ```yaml
  ---
  유형: 허브 | 노트 | 참고 | 결정 | 인덱스
  상위: "[[상위 노트]]"      # 허브/인덱스는 생략 가능
  출처: []                   # 코드 경로·URL·raw 파일 등 역추적용
  updated: YYYY-MM-DD
  confidence: high | medium | low   # 참고/사실 노트에 권장
  ---
  ```
- 본문 첫 줄은 `# 제목`, 그 아래 `← 돌아가기: [[상위 노트]]`
- 노트당 **한 가지 주제**. 길어지면 쪼개고 `[[링크]]`로 잇는다.

## 2. 연결 (가장 중요)
- 개념·노트 참조는 **반드시 `[[위키링크]]`** 로. 맨 텍스트로 언급하지 말 것.
- 새 노트는 **고아로 두지 않는다** — 최소 1개 상위(허브/MOC)에 연결.
- 아직 안 쓴 노트도 `[[예약 이름]]`으로 미리 링크 가능(흐릿한 노드).

## 3. 정리 구조 (4축 second brain)
- 최상위 진입점 = `index.md` (전체 MOC). 4개의 문으로 라우팅한다.
- **4축은 폴더가 아니라 `index.md`의 섹션(MOC)** 으로 존재함:
  | 축 | 존재함 | 채워지는 법 |
  |---|---|---|
  | 🗂 업무 | `wiki/` 노트 + 홈 업무섹션 | `raw/` → `/ingest` |
  | 📚 학습 | `wiki/` 노트 + 홈 학습섹션 | `raw/` 자료 → `/ingest` |
  | 💭 사고 | `wiki/` 노트 + 홈 사고섹션 | `raw/`에 생각 던지기 → `/ingest` |
  | ⚖️ 결정 | `wiki/` 결정노트(`유형: 결정`) + 홈 결정섹션 | 결정 시 append-only로 기록 |
- 새 주제 생기면 `index.md` 해당 섹션에 한 줄 추가. 주제별 허브 노트가 그 주제의 작은 MOC 역할.
- **폴더보다 링크·MOC로 정리한다** (폴더는 `raw`·`wiki` 최소만).
- **바이너리(이미지·PDF 등)는 `assets/`** 에 둔다. 폴더는 첫 파일이 생길 때 만든다(미리 안 만듦).
- **ingest한 원본은 `raw/processed/`로 옮긴다** — `raw/` 최상위에 남은 `.md`가 곧 미처리(todo). `raw/processed/` 폴더는 첫 ingest 때 생긴다.
- **한 축/폴더의 노트가 ~30개를 넘으면** → 독립 MOC·하위 그룹으로 분리(`/lint`이 제안). 미리 쪼개지 않는다.

## 4. 출처 추적 (raw 계층 규칙)
- 사실·규칙 노트는 `출처:`에 근거를 박는다 (코드 경로·URL·`raw/processed/<파일>.md` 등). ingest한 raw는 `raw/processed/`에 있으니 그 경로로 인용.
- 원본(raw·코드베이스)은 **내용 수정 대상이 아님**. 위키는 원본을 가리킬 뿐.
- (선택) 외부 소스 디렉터리(예: 코드프로젝트의 메모)를 `raw/` 안에 **심링크**로 걸어 단일 소스 레이어로 둘 수 있다 — 심링크 대상도 읽기 전용.

## 5. 미리 채우지 않기
- 노트는 **방금 알게 됐거나 지금 필요한 것**만 만든다.
- "언젠가 쓸지 몰라서" 미리 채우지 않는다 (냉장고 안 채우기).

## 6. Lint (요청 시 수행)
"보관함 점검해줘" 요청이 오면 스캔해서 보고:
- 들어오는 링크 없는 **고아 노트**
- 참조됐지만 안 쓴 **빈 노드**
- 노트 간 **모순** / 원본과 어긋난 **낡은 주장**
- 형식 위반(프론트매터 누락 등)
- 한 축/폴더가 **~30개 플랫 노트**를 넘으면 → 하위 MOC로 분할 제안
- `CLAUDE.md`의 경로·규칙이 실제 구조와 **어긋났는지**(파일 이동·리네임 후 드리프트)
- **미처리 raw** — `raw/` 최상위에 남은 `.md`(= 아직 `raw/processed/`로 안 옮긴 것 = ingest 백로그). 목록만 보고.
→ 결과는 인라인 보고 + `log.md`에 한 줄 요약 append. (커맨드: `/lint`)

## 7. 운영 동작 (슬래시 커맨드)
`.claude/commands/`에 세 동작이 정의돼 있다. **보관함 폴더에서 `claude` 실행** 시 사용:
- **`/ingest <원본>`** — 원본을 읽고 요약 노트 작성 → 관련 노트 연결 → `index.md`·`log.md` 갱신 → 로컬 원본을 `raw/processed/`로 이동.
- **`/query <질문>`** — `index.md`(인덱스)부터 읽고 관련 노트로 드릴다운 → 출처 단 답. (벡터 RAG 안 씀)
- **`/lint`** — 위 6번 점검 수행 → 인라인 보고 + `log.md` 한 줄 요약.

## 8. 활동 로그 (`log.md`)
- 위키에 의미 있는 변화(ingest·결정·lint)가 생기면 `log.md` **맨 끝에만 추가**한다.
- 형식: `## [YYYY-MM-DD] <동작> | <대상>` + 한 줄. **기존 줄은 절대 수정 금지**(역추적용 원장).

## 9. 결정 기록 (`유형: 결정` 노트 — ADR식)
- 업무·설계 결정은 `wiki/`에 `유형: 결정` 노트로 남기고, `index.md` ⚖️결정 섹션에 링크한다. (별도 `decisions/` 폴더 안 씀 — 축은 폴더가 아니라 섹션.)
- **append-only**: 채택된 결정 노트는 LLM이 재작성하지 않는다. 바뀌면 새 결정 노트를 만들고 옛 것과 `[[링크]]`로 잇는다(상태: 폐기).
- 매 기록에 **맥락 + 근거(rationale) + confidence**를 반드시 적는다.

## 절대 규칙
- 한국어로 작성 (이 보관함 언어 — 다른 언어를 쓰려면 이 줄을 바꾼다).
- 노트를 지우기 전엔 내용을 확인하고, 사용자가 만든 것이면 먼저 묻는다.