ADR-0002 — Karpathy 패턴 LLM Wiki 도입¶

Context¶

코드/기획/회의록이 여러 곳(GitHub, Notion, Slack)에 흩어져 있어 LLM이 매 질문마다 처음부터 재발견하는 비용 발생
Karpathy의 LLM wiki 가설: "wiki is a persistent, compounding artifact" — 누적적 아티팩트로 컨텍스트 관리
신규 기능(사고력 답변 + 챌린지 풀이) 도입 시 기획-구현-결정 이력을 한 곳에 모을 필요

3계층 구조 채택:
raw/ — 불변 원본 (Notion 기획 등 append-only)
wiki/ — LLM이 유지하는 도메인·컨셉·결정 페이지
CLAUDE.md — schema 문서 (LLM 동작 규약) — 2026-05-20에 AGENTS.md → CLAUDE.md로 rename
wiki/ 하위 구조: index.md, log.md, domains/, concepts/, decisions/
raw/ 불가침 원칙: LLM은 raw/를 직접 수정하지 않음. 갱신은 MCP/스크립트만
wiki 페이지는 frontmatter(id/title/type/status/sources/updated/supersedes) 필수
변경 이력은 wiki/log.md에 append-only로만 기록
Notion 동기화는 MCP server(@notionhq/notion-mcp-server)로

긍정: - 카파시가 지적한 "LLM rediscovering knowledge from scratch" 문제 완화 - 코드 변경 ↔ 도메인 컨텍스트 한 레포에서 동기화 가능 - ADR 누적으로 결정 사유 추적 가능

부정: - wiki 유지보수 작업 추가 (lint 주간 수동) - 자동화 부족 — 코드 변경 시 wiki 자동 갱신은 안 함(잘못 갱신 위험 회피)

2026-05-19