Ai 마법서

LLM-Wiki-튜토리얼

7 min read

LLM Wiki 구축 튜토리얼

왜 ? LLM Wiki 를 구축하는가? 안드레이 카파시에 따르면 AI 가 아직 하지 못하는 것이 “Understanding” 이다. 이를 해결하기 위한 방편으로 Wiki를 구축하려고 하는 것이다.

Karpathy의 “LLM Wiki” 패턴을 내 볼트에 맞춰 셋업하는 6단계 가이드. 이 문서는 읽고 따라하는 학습자료다. 실행은 별도 세션에서.

0. 이 튜토리얼이 만드는 것

  • raw/ — 내가 넣는 원본 자료 (불변)
  • wiki/ — AI가 raw를 읽어 정리·연결하는 위키 (index.md, log.md 포함)
  • Output/ — 위키를 활용한 산출물
  • CLAUDE.md — 나의 정체성·역할·규칙을 AI에게 매번 주입하는

목적: AI가 내 맥락 위에서 작동하는 “세컨드 브레인” 구축.

Step 1 · WikiSeed.md 작성 (수동, 5분)

볼트 루트에 WikiSeed.md를 만들고, 한 줄씩 3줄만 쓴다.

1. **나는 누구인가** — 이름, 하는 일, 역할
2. **왜 기록하고 싶은가** — 지금 뭐가 안 되는지, 기록이 되면 뭐가 달라지는지
3. **어떤 아웃풋을 만들고 싶은가** — 누구를 위해, 어떤 형태로

⚠️ 길게 쓰지 말 것. 인터뷰의 출발점일 뿐.

Step 2 · 인터뷰 시작 프롬프트 (AI에게)

새 채팅을 열고 아래 프롬프트를 그대로 붙여넣는다.

우리는 지금 "AI를 위한 세컨드 브레인"을 만들고 있어.

목적: 세상에 있는 {주제} 관련한 유용한 정보와 지식을 체계적으로 모으고,
나의 맥락에 맞게 정리·연결해서, AI가 이를 읽고 활용하여 {목적} 할 수 있게 하는것.

'WikiSeed.md'는 내가 사전에 작성한 자기소개야.
이걸 읽고, 나의 맥락을 더 깊이 이해하기 위해 인터뷰해줘.

{주제} {목적} 자리는 본인 상황에 맞게 채울 것.

Step 3 · 인터뷰 진행 → “나의 핵심 맥락.md”

  • AI가 질문을 던진다 → 솔직하게 답한다.
  • 인터뷰가 끝나는 신호가 보이면 명시적으로 요청:
인터뷰 끝났어. 이제 **나의 핵심 맥락.md** 파일로 정리해줘.

산출물: 볼트 루트에 나의 핵심 맥락.md 생성됨.

Step 4 · CLAUDE.md 생성

AI에게:

내 볼트에 "나의 핵심 맥락.md" 파일이 있어.
이 파일을 읽고, CLAUDE.md를 만들어줘.

포함할 섹션:
1. "## 나는 누구인가" → 이름, 하는 일, 핵심 가치
2. "## 나의 역할들" → 각 역할별: 하는 일, 주요 관심사
3. "## 나의 비전과 목표" → 이루고자 하는 것, 타겟 독자/고객
4. "## AI에게 기대하는 것" → 어떤 도움을 원하는지
5. "## 작업 규칙" → 톤, 언어, 결과물 형태

스타일:
- 간결하게, 핵심만
- AI가 매번 읽는다고 생각하고 작성
- 빈칸이 있어도 괜찮아 — 채워진 것만으로 만들어줘

참고: 이미 프로젝트용 CLAUDE.md가 있다면 충돌 검토 필요.

Step 5 · LLM Wiki 셋팅

AI에게:

아래는 Karpathy의 "LLM Wiki" 패턴이야.
내 CLAUDE.md를 읽고, 이 아이디어를 나에게 맞춰서 세팅해줘.

[Karpathy Idea File 전문 붙여넣기]
(원본: https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)

해줄 것:
1. 내 목적에 맞는 폴더 구조 만들기
   - raw/ → 불변 원본 (내 인풋 유형별 하위 폴더)
   - wiki/ → AI가 컴파일하는 위키
   - Output/ → 결과물
2. CLAUDE.md에 위키 운영 규칙 추가
3. 각 주요 폴더에 하위 CLAUDE.md 생성
4. wiki/index.md 초기화
5. wiki/log.md 초기화

위키 운영 핵심 규칙 10가지

  1. raw/는 절대 수정 금지 (불변 원본)
  2. wiki 페이지 생성/삭제 시 index.md 필수 업데이트
  3. 모든 오퍼레이션마다 log.md에 기록
  4. 내부 참조는 wikilink 형식 ([[페이지명]])
  5. 모든 wiki 페이지에 YAML frontmatter
  6. 모순 발견 시 양쪽 소스 모두 인용
  7. 소스 요약은 사실만, 해석은 개념 페이지에서
  8. 질의 시 index.md 먼저, raw/는 최후의 수단
  9. 새 페이지보다 기존 페이지 업데이트 우선
  10. index 항목은 한 줄, 120자 이내

Step 6 · 사용 사이클

[자료 수집] → raw/ 에 파일 넣기
[컴파일]   → AI에게 "컴파일해라"
[질의]     → AI가 wiki/index.md → 관련 페이지 → (필요 시) raw/ 순으로 탐색
[산출]     → Output/ 에 결과물

체크리스트

  • WikiSeed.md 3줄 작성
  • 인터뷰 완료, 나의 핵심 맥락.md 생성
  • CLAUDE.md 생성·검토
  • raw/, wiki/, Output/ 폴더 구조 셋업
  • wiki/index.md, wiki/log.md 초기화
  • 운영 규칙 10가지를 CLAUDE.md에 반영
  • 첫 raw 파일 투입 → 컴파일 시연

참고

Graph View