색인과 기록 세우기
1. 색인과 기록 세우기
위키에는 특별한 파일이 둘 있습니다. index.md와 log.md입니다. 둘 다 위키의 내용이 아니라 위키에 대한 정보를 담습니다. 카파시의 원문이 이 둘을 따로 떼어 설명하는 이유는, 이 둘이 있으면 검색 시스템을 따로 만들지 않아도 위키가 굴러가기 때문입니다.
1.1 index.md는 무엇을 담나
index.md는 내용 중심의 목록입니다. 위키에 있는 모든 문서를 링크와 한 줄 설명으로 나열합니다.
# 위키 색인
마지막 갱신: 2026-08-16
## 대상 (entities)
- [[competitor-a]] 온라인 강의 서비스. 14일 무료 체험, 팀 결제 중심. (자료 2건)
- [[competitor-b]] 온라인 강의 서비스. 7일 무료 체험, 개인 구독 중심. (자료 1건)
## 개념 (concepts)
- [[free-trial]] 무료 체험 정책의 길이와 전환 설계
- [[team-pricing]] 팀 단위 결제 구조
## 종합 (topics)
- [[pricing-comparison]] 경쟁사 요금제 비교표와 해석
## 결정 (decisions)
- 아직 없음
여기서 중요한 것은 한 줄 설명입니다. 파일 목록만 있으면 폴더를 보는 것과 다를 바 없습니다. 한 줄 설명이 있어야 AI가 "이 질문에 관련 있는 문서가 어느 것인가"를 파일을 열지 않고 판단할 수 있습니다.
카파시의 원문은 이 방식이 자료 100건, 문서 수백 장 규모까지 놀랄 만큼 잘 동작한다고 적습니다. 임베딩 기반 검색 시스템을 붙이지 않아도 되는 이유가 여기 있습니다. 질문이 들어오면 AI는 색인을 먼저 읽고, 관련 있어 보이는 문서 세 장만 펼칩니다.
1.2 색인을 다시 만들기
3장에서 만든 index.md가 부실하다면 지금 다시 만듭니다.
index.md를 다시 만들어줘.
- wiki/ 안의 모든 문서를 폴더별로 묶어 나열해줘.
- 각 항목은 [[문서-이름]] 링크와 한 줄 설명으로.
- 한 줄 설명은 그 문서의 '한 줄 요약'에서 가져오되,
없으면 문서를 읽고 새로 써줘.
- entities 항목에는 그 대상에 연결된 원본 자료 건수도 적어줘.
- 맨 위에 마지막 갱신 날짜를 넣어줘.
만들어진 색인을 Obsidian에서 엽니다. 링크가 전부 파랗게 보이고 눌러서 이동되면 정상입니다. 회색으로 보이는 링크가 있다면 그 문서가 실제로는 없다는 뜻입니다. 색인에 없는 문서를 적었거나 파일 이름이 어긋난 것입니다.
이 확인이 편한 것이 Obsidian을 쓰는 이유 중 하나입니다. 대화창에서는 링크가 살아 있는지 확인할 방법이 없습니다.
1.3 log.md는 무엇을 담나
log.md는 시간 중심입니다. 무슨 일이 언제 있었는지를 위에서부터 쌓습니다.
# 작업 기록
## [2026-08-16] ingest | 경쟁사 B 요금제 페이지
- 원본: raw/2026-08-16-competitor-b-pricing.pdf
- 새 문서: entities/competitor-b, topics/pricing-comparison
- 갱신: entities/competitor-a, concepts/free-trial, index.md
## [2026-08-14] ingest | 경쟁사 A 요금제 페이지
- 원본: raw/2026-08-14-competitor-a-pricing.pdf
- 새 문서: entities/competitor-a, concepts/free-trial
- 갱신: index.md
형식에서 눈여겨볼 것은 제목 줄입니다.
## [YYYY-MM-DD] 동작 | 제목
날짜와 동작 종류를 항상 같은 자리에 두면 이 파일이 기계적으로 읽힙니다. 나중에 "최근 다섯 건만 보여줘"나 "지난달 린트 기록만 뽑아줘" 같은 요청이 정확하게 처리됩니다.
동작 종류는 세 가지면 충분합니다.
| 표기 | 언제 |
|---|---|
ingest | 새 자료를 넣었을 때 |
query | 질의 결과를 문서로 남겼을 때 |
lint | 위키를 점검했을 때 |
1.4 둘의 역할이 어떻게 갈리나
같은 정보를 두 군데 적는 것처럼 보이지만 쓰임이 다릅니다.
index.md는 지금 위키에 무엇이 있는지를 답합니다. 문서가 지워지면 색인에서도 지워집니다. 현재 상태만 담습니다.
log.md는 과거에 무슨 일이 있었는지를 답합니다. 문서가 지워져도 기록은 남습니다. 지운 것도 기록입니다.
둘 중 하나만 두면 이런 일이 생깁니다. 색인만 있으면 "이 문서가 언제 왜 만들어졌지"에 답할 수 없습니다. 기록만 있으면 "지금 위키에 뭐가 있지"에 답하려고 기록 전체를 읽어야 합니다.
1.5 색인이 갱신되는지 확인하기
색인과 기록은 인제스트할 때마다 자동으로 갱신돼야 합니다. 규칙 문서에 절차로 적어 뒀지만 실제로 지켜지는지 봅니다.
자료를 하나 더 넣고, 인제스트가 끝난 뒤 Obsidian에서 index.md와 log.md를 엽니다. 새 항목이 들어가 있으면 정상입니다.
빠져 있다면 두 가지 중 하나입니다. 규칙 문서를 안 읽었거나, 절차가 너무 길어 뒤쪽이 흐려진 것입니다. 후자라면 인제스트 절차의 순서를 바꿔 색인 갱신을 앞으로 당깁니다.
한동안 위키를 방치했다가 돌아왔을 때는 색인부터 맞춥니다.
wiki/ 폴더의 실제 파일 목록과 index.md를 대조해줘.
색인에 없는 문서, 색인에는 있는데 실제로 없는 문서를 각각 알려주고
index.md를 실제 상태에 맞게 고쳐줘.
색인이 실제와 어긋나면 질의가 조용히 나빠집니다. AI가 색인을 믿고 문서를 고르기 때문에, 색인에 없는 문서는 있어도 없는 것과 같습니다.
다음 절에서 Obsidian을 작업대로 쓸 수 있게 손봅니다.