위키 = AI Ready Codebase 의 문서형 (Wiki as the AI-Ready Map, in Document Form)
별칭: Wiki as AI Ready Map · Wiki = Map · 위키는 지도
요약
본 강의의 위키는 위키에 대해 설명하는 위키 라는 흥미로운 자기 참조 구조를 가지고 있다. 즉 본 강의 위키 자체가 concept/ai-ready-codebase (AI Ready 코드베이스) 의 문서 형태로 구현된 사례 라는 의미다. 이를 재귀적 동형 (recursive isomorphism) 이라고 부를 수 있는데, 코드베이스 = 위키 라는 등치가 성립하므로 AI Ready 코드베이스의 운영 규칙이 그대로 본 위키의 운영 규칙으로 적용된다. 더 구체적으로는 — 위키의 각 카드가 모듈별 CLAUDE.md 역할을 하며, 카드 간 wikilink 가 모듈 간 의존성 관계 와 같다. 본 카드는 위키를 어떻게 운영할 것인가 라는 메타 질문에 대해 AI Ready 원칙을 위키 자신에게 적용하라 는 단순한 답을 제시한다.
상세
핵심 명제
"A codebase — or a wiki — is AI-ready when an agent can navigate it without grepping blindly. The wiki is the codebase here, so the rule applies recursively." — Context Engineering Guide §A1-1
Wiki ↔ Codebase 동형 매핑
| 코드베이스 (하재상 메타 사례) | 위키 (본 강의) |
|---|---|
| 4,100 파일 코드 | ≈140 카드 |
| 모듈 (auth, payment 등) | 6 섹션 (INT/VBC/HRN/DSL/DEM/CLN) + 7 type |
| 모듈별 CLAUDE.md (25~35 줄) | Wiki Card (각 카드 = 모듈별 CLAUDE.md) |
| 루트 CLAUDE.md (≤200 줄) | 30_wiki/index.md (≤200 줄, 지도 형식) |
| 5 questions per CLAUDE.md | concept/snlm-card-standard 9 sections (5Q ⊆ 9S) |
| Non-obvious Pattern | Wiki Card 의 Constraints 섹션 + 안티패턴 카드 |
| 자동 갱신 hook | Wiki 의 Stop / SessionStart hook + lint pass |
→ 카드 분해 = 모듈 CLAUDE.md 분해 (case/ha-jaesang-meta-pipeline-claude-md 의 5%→100% 효과가 위키에도 동일).
Karpathy 1 source → 10~15 cards 와 동형
- Karpathy: 1 source → 10~15 cards (분해 본능)
- HIAO: 1 → 3·4 → 9·16 (계층 분해)
- AI Ready: 1 module → 1 CLAUDE.md (모듈 분해)
- → 모두 같은 본능의 다른 축
위키가 Map (지도) 인 이유
"위키는 *백과사전이 아니라 나침반. AI 한테 모든 걸 다 알려 주려고 하면 안 되고 — 방향만 어디로 가야 할지만."
→ 루트 index.md = 지도, 각 카드 = 지도의 좌표.
Viewer = IDE, LLM = Programmer, Wiki = Codebase
"The viewer is the IDE; the LLM is the programmer; the wiki is the codebase." — Context Engineering Guide
| 역할 | 본 강의 | 의미 |
|---|---|---|
| IDE | https://ai.llmwiki.kr/ (Next.js 16 viewer) | 사람이 읽는 도구 |
| Programmer | LLM (Claude / GPT) | 쓰는 주체 |
| Codebase | 30_wiki/ (≈140 카드) | 유지되는 자산 |
검증 — 본 위키의 AI Ready 점수
본 강의 위키 자체가 concept/ai-ready-codebase 의 7 영역 100점 루브릭 적용 가능:
- ✅ AI 내비게이션 커버리지 —
30_wiki/index.md카탈로그 - ✅ 컨텍스트 문서 품질 — 카드별 concept/snlm-card-standard 9 섹션
- ✅ Tacit Knowledge 구조화 — 안묵지 → term/concept 카드
- ✅ 변경 영향 범위 — wikilinks 추적
- ✅ 컨텍스트 프레시니스 — log.md append + Stop hook (예정)
- ✅ 검증 품질 게이트 — frontmatter 검증 + lint
- 🔜 에이전트 성능 측정 — S5 단계에서 도입
→ 현재 ≈ A 그레이드 (Agentic Ready 진입).
방법론
강의 활용 (Ch 3 lesson/dsl-claudemd-as-language / Ch 5 AI Ready Codebase 단원):
- 재귀 동형 명제 (1분): "위키도 코드베이스 — AI Ready 규칙이 재귀적으로 적용."
- 위키 ↔ 코드베이스 매핑 표 (2분): 4,100 파일 → ≈140 카드 동형.
- IDE = Viewer / Programmer = LLM / Codebase = Wiki (1분): 새 비유.
- 본 위키의 AI Ready 점수 (1분): 자기 점검 — 우리 위키가 그 패턴의 적용 사례 자체.
주의사항
- 재귀의 함정: "위키 안에 또 위키" 같은 무한 재귀로 흐르지 않게. 위키 1 층 만 재귀.
- Codebase 와 Wiki 의 본질적 차이: 코드는 실행, 위키는 읽기·LLM 입력. 동형이지만 동일 아님.
- 본 카드의 메타 성격: 본 위키의 자기 참조 — 우리가 만든 위키가 우리가 가르치는 패턴 의 적용 사례. 청중에게 살아있는 데모 효과.
- 상위 종합: synthesis/context-engineering-guide-overview 의 마스터 SSOT 와 짝 — 본 카드는 위키 자체의 자기 인식.
표어 정합
본 카드의 위키 = AI-Ready Map 명제가 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 의 시스템 형태 다. 설계 없이는 코딩이 안된다 (Thesis) 의 Design 이 지속 가능한 형태 로 박히는 자리 — 위키. AI 에게 어떻게 일을 시키는가 (Corollary) 가 카드 컬렉션 으로 외재화된다.