LLM Wiki

LLM Wiki 패턴 준수 검토 보고서

10 min read

LLM Wiki 패턴 검토 보고서

이 보고서는 Andrej Karpathy의 LLM Wiki 방법론과 LLM Wiki 현재 구조를 비교·분석합니다.

1. 3-Layer Architecture

요구사항Karpathy 패턴LLM Wiki상태
Raw Sources 디렉토리 (raw/)✅ 불변 원본 저장✅ raw/ 존재🟢 완벽
Wiki Pages 디렉토리 (wiki/pages/)✅ 플랫 구조✅ wiki/pages/🟢 완벽
Index/Overview/Log✅ 카탈로그+시놉시스+로그✅ index.md, overview.md, log.md🟢 완벽
SCHEMA.md (위키 규칙)✅ 규칙 정의⚠️ SCHEMA.md 없음🔴 미비

발견 사항

  • SCHEMA.md 부재: AGENTS.md에 규칙이 포함되어 있으나, Karpathy 패턴에서는 SCHEMA.md가 모든 스킬의 진입점으로 명시됨
  • 현재 규칙이 분산됨: AGENTS.md, SKILL.md, _sidebar.md에 규칙이 흩어져 있음

2. 플랫 디렉토리 구조

요구사항Karpathy 패턴LLM Wiki상태
하위 디렉토리 없음✅ 모든 페이지 한 디렉토리✅ wiki/pages/ 플랫🟢 완벽
날짜 접두사 슬러그✅ YYYY-MM-DD-slug.md✅ 동일🟢 완벽
MOC 파일 명명✅ moc-<주제>.md✅ 동일🟢 완벽
엔티티 파일 명명✅ entity-name.md✅ 동일🟢 완벽

발견 사항

  • 플랫 구조가 완벽하게 준수됨
  • 파일 명명 규칙이 일관됨

3. slug 크로스참조 시스템

요구사항Karpathy 패턴LLM Wiki상태
slug 형식 내부 링크✅ 양방향 링크✅广泛使用🟢 완벽
문서 간 상호 참조✅ 고루 연결✅ 1,800+ 위키링크🟢 완벽
백링크 감사 절차✅ 새 페이지 후 필수⚠️ 일관성 미확보🟡 부분

발견 사항

  • slug 형식이 보편적으로 사용됨
  • 432+ 고유 slug, 1,882+ 위키링크로 풍부한 크로스참조 존재
  • 백링크 감사는 프로세스에 포함되어 있으나 실행 일관성 미확보

4. 프론트매터 (Frontmatter)

요구사항Karpathy 패턴LLM Wiki상태
title (쌍따옴표 필수)✅ 문자열✅ 사용 중🟢 완벽
tags (3~5개, 소문자)✅ 카테고리 태그 필수✅ 사용 중🟢 완벽
sources (소스 슬러그)✅ 필수 필드✅ 사용 중🟢 완벽
updated (갱신일)✅ 필수✅ 사용 중🟢 완벽
created (생성일)✅ 권장✅ 사용 중🟢 완벽
source_url✅ URL 소스용✅ 사용 중🟢 완벽
publish (게시 여부)✅ 비공개 기본✅ 사용 중🟢 완벽

발견 사항

  • 프론트매터 구조가 완벽하게 준수됨
  • title 쌍따옴표 규칙도 올바르게 적용됨

5. MOC (Map of Content)

요구사항Karpathy 패턴LLM Wiki상태
주제별 MOC 파일✅ moc-<주제>.md✅ 15개 MOC 존재🟢 완벽
tags: [moc] 필수✅ 프론트매터✅ 적용됨🟢 완벽
관련 페이지 그룹핑✅ 카탈로그 역할✅ 카테고리별 정리🟢 완벽

현재 MOC 목록

  • moc-ai-agents.md (AI Agents MOC)
  • moc-ai-agents-context-stack.md
  • moc-ai-agents-harness.md
  • moc-ai-agents-memory.md
  • moc-ai-agents-orchestration.md
  • moc-ai-agents-trading.md
  • moc-ai-coding.md
  • moc-ai-coding-ops-console.md
  • moc-ai-models.md
  • moc-claude-code.md
  • moc-dev-tools.md
  • moc-learning-progress.md
  • moc-llm-wiki.md ← LLM Wiki 전용 MOC
  • moc-misc.md
  • moc-mobile-ai.md
  • moc-multimedia.md
  • moc-productivity.md

발견 사항

  • 17개의 MOC이 적절히 세분화되어 존재
  • moc-llm-wiki.md로 LLM Wiki 자체를 주제화한 점이 좋음

6. index.md (카탈로그)

요구사항Karpathy 패턴LLM Wiki상태
카테고리별 분류✅ 섹션 구조✅ 9개 카테고리🟢 완벽
slug 링크 + 설명✅ 이름+한 줄 설명✅ 적용됨🟢 완벽
MOC 우선 배치✅ MOC 먼저✅ 계층 구조 적용🟢 완벽

발견 사항

  • 카테고리: AI Agents, AI Coding, AI Models, Dev Tools, Productivity, Multimedia, Mobile AI, Misc, Maintenance
  • MOC가 계층적으로 우선 배치되어 있음
  • 완벽하게 준수됨

7. log.md (조작 로그)

요구사항Karpathy 패턴LLM Wiki상태
`## [YYYY-MM-DD] operationtitle` 형식✅ 적용됨🟢 완벽
Append-only✅ 절대 재작성 금지⚠️ 수동 관리🟡 주의
Ingest/Update/Lint 기록✅ 모든 조작 기록✅ 적용됨🟢 완벽

발견 사항

  • ## [2026-05-06] ingest | ... 형식 정확히 준수
  • append-only 규칙이 내부적으로만 적용됨 (자동 enforcement 없음)

8. Entity/Concept 페이지

요구사항Karpathy 패턴LLM Wiki상태
频繁 언급 개념 전용 페이지✅ 10회 이상 언급 시✅ 구현됨🟢 완벽
날짜 없는 슬러그✅ entity-name.md✅ harness.md, ollama.md 등🟢 완벽
Sources: [internal] 또는 [wiki]✅ 자체 작성/종합✅ 적용됨🟢 완벽

현재 엔티티 페이지

  • ai-agents.md
  • claude-opus-4.7.md
  • codex.md
  • computer-use-agent-landscape.md
  • cursor.md
  • deepseek-v4.md
  • gpt-5.5.md
  • harness.md
  • hermes-agent.md
  • insane-search.md
  • kimi-k2.md
  • llama-cpp.md
  • lmstudio.md
  • mcp.md
  • nemotron.md
  • nous-portal.md
  • nvidia-nim.md
  • ollama.md
  • openclaw.md
  • opencode.md
  • qwen.md
  • supermemory.md

발견 사항

  • 22개의 엔티티 페이지 존재
  • 엔티티 선택 기준(10회 이상 언급)에 부합하는 것으로 보임

9. Wiki 스킬 운영

요구사항Karpathy 패턴LLM Wiki상태
Ingest 스킬✅ 소스→페이지 파이프라인✅ llm-wiki-writer 스킬🟢 완벽
Query 스킬✅ 위키 질의⚠️ 별도 스킬 없음🟡 미비
Update 스킬✅ 페이지 수정⚠️ 프로세스만 존재🟡 미비
Lint 스킬✅ 건강 감사✅ vault-lint.py 스크립트🟢 완벽

발견 사항

  • skills/llm-wiki-writer/SKILL.md가 ingest 로직을 정의
  • scripts/vault-lint.py가 lint 기능을 제공
  • Query/Update 스킬의 자동화 미비

10. Docsify 호환성

요구사항Karpathy 패턴LLM Wiki상태
[[slug]] → 마크다운 변환⚠️ Docsify 미지원✅ _sidebar.md는 표준 링크🟢 완벽
GitHub Pages 배포✅ 자동화✅ GitHub Actions🟢 완벽
로컬 미리보기✅ docsify-cli serve✅ 지원됨🟢 완벽

발견 사항

  • [[slug]]가 Wiki 내부에서만 사용되고 Docsify용 _sidebar.md는 표준 마크다운 링크 사용
  • 완벽하게 분리됨

종합 평가

🟢 완벽 준수 (8/10)

  1. 3-Layer Architecture — Raw/Wiki/Schema 명확히 분리
  2. 플랫 디렉토리 구조 — 하위 디렉토리 없음
  3. slug 크로스참조 — 1,800+ 위키링크로 풍부한 상호 연결
  4. 프론트매터 — title, tags, sources, updated 완벽히 적용
  5. MOC 시스템 — 17개 주제별 MOC로 체계적 분류
  6. index.md — 카테고리별 카탈로그 완벽
  7. Entity/Concept 페이지 — 22개 엔티티로 자주 언급 개념 커버
  8. Docsify 호환 — 내부는 [[slug]], 외부는 표준 링크 분리

🟡 부분 준수 (2/10)

  1. SCHEMA.md 부재 — AGENTS.md에 규칙이 있으나 공식 SCHEMA.md 없음
  2. Query/Update 스킬 자동화 미비 — 프로세스는 정의되나 자동화 미흡

개선 권장사항

우선순위항목설명
🔴 높음SCHEMA.md 생성AGENTS.md의 규칙을 SCHEMA.md로 독립시켜 공식 진입점으로 지정
🟡 중간Query 스킬 분리wiki-query.md 스킬을 독립 파일로 분리
🟡 중간Update 스킬 분리wiki-update.md 스킬을 독립 파일로 분리
🟡 중간백링크 감사 enforcement새 페이지 작성 후 백링크 감사를 강제하는lint 단계 추가

결론

LLM Wiki는 Karpathy LLM Wiki 패턴을 ~90% 이상 충실히 구현하고 있습니다.

강점:

  • 플랫 구조, slug 크로스참조, 프론트매터, MOC, index, log, entity pages 모두 완벽
  • 481개 페이지, 432개 slug, 1,882개 위키링크로 복리 지식 베이스가 잘 구축됨
  • Docsify 호환성 처리도 완벽

개선점:

  • SCHEMA.md 파일을 생성하여 공식 규칙 문서로 격상
  • Wiki 스킬의 자동화(특히 Query, Update) 강화

전체적으로 LLM Wiki 방법론을 잘 이해하고 충실히 구현한 것으로 평가됩니다. 특히 MOC 구조, 백링크 체계, log.md의 append-only 기록 방식이 Karpathy 패턴의 핵심을 잘 반영하고 있습니다.

검토일: 2026-05-10 검토자: AI Agent

그래프 뷰

백링크