index·log 운영

LLM Wiki가 커질 때 LLM과 사람이 길을 찾게 해 주는 두 특수 파일이다. 목적이 서로 다르다. Karpathy LLM Wiki

근거: Karpathy LLM Wiki

index.md#

단계#

1. 카테고리별로 "위키링크 — 한 줄 요약" 형식으로 적는다. 예시는 이 위키의 index.
2. 수집할 때마다 LLM이 갱신한다. → LLM Wiki 수집(Ingest)
3. 질의할 때 LLM이 index를 먼저 읽고 관련 페이지로 들어간다. → LLM Wiki 질의(Query)

근거: Karpathy LLM Wiki

언제 index만으로 충분한가#

원본 약 100개, 페이지 수백 개 규모에서는 index만으로 놀랄 만큼 잘 돌아가며, 임베딩 기반 RAG 인프라가 필요 없다(원본 표현: moderate scale). 원본은 이 숫자를 '중간 규모'의 예로 들 뿐 경계를 정하지 않고, 위키가 커지면 제대로 된 검색이 필요해진다고 덧붙인다("as the wiki grows you want proper search"). 그때는 qmd 같은 검색 엔진을 붙인다. Karpathy LLM Wiki

컨텍스트 관점 (편집자 해석)#

Anthropic 컨텍스트 엔지니어링 글은 에이전트가 파일 경로 같은 가벼운 식별자만 들고 있다가 필요할 때 도구로 불러오는 just-in-time 방식을 설명한다(이 글은 LLM Wiki를 언급하지 않는다). 효과적인 컨텍스트 엔지니어링 index.md는 위키 전체를 컨텍스트(용어 사전)에 넣지 않고 페이지 링크와 한 줄 요약만 먼저 읽게 한다는 점에서 이런 식별자 목록에 가깝다. → 컨텍스트 엔지니어링

log.md#

단계#

1. 모든 항목을 같은 접두어로 시작한다.
2. 맨 아래에 추가만 한다.
3. 최근 기록은 유닉스 도구로 뽑는다.

실제 예시#

## [2026-04-02] ingest | Article Title

grep "^## \[" log.md | tail -5   # 최근 5개 항목

근거: Karpathy LLM Wiki. 일정한 접두어 덕분에 log가 간단한 유닉스 도구로 파싱된다. log는 위키가 어떻게 변해 왔는지 보여 주고, LLM이 최근에 무엇을 했는지 파악하게 돕는다.

언제 쓰지 않는가#

원본은 모든 요소가 선택적이라고 말한다. 다만 index와 log는 위키를 탐색하는 기본 장치로 소개되며, 쓰지 말아야 할 경우는 따로 들지 않는다. Karpathy LLM Wiki