Obsidian + LLM Knowledge Base 세팅 가이드: 폴더 구조부터 운영 규칙까지 한 번에 정리
많은 사람이 LLM Knowledge Base를 좋다고 말하지만, 막상 시작하려고 하면 첫 단계에서 막힙니다.
- 폴더를 어떻게 나눌지
- 원문과 요약을 어디에 둘지
- 어떤 규칙으로 업데이트를 시킬지
여기서 애매하면 1주일 안에 시스템이 무너집니다. 이 글은 바로 실행 가능한 세팅 기준을 정리합니다.
1. 시작 전에 먼저 정할 것 3개
1) 목적
“무엇을 위해 KB를 돌리는지”를 한 줄로 적어야 합니다. 예:
- 결제 장애 대응 지식 누적
- AI 리서치 아카이브 구축
- 제품 기획 근거 문서화
목적이 없으면 문서만 쌓이고 활용은 안 됩니다.
2) 소스 범위
처음부터 모든 문서를 넣지 마세요. 처음 2주는 아래처럼 범위를 좁혀야 합니다.
- 최근 3개월 핵심 문서만
- 팀이 자주 찾는 문서만
3) 업데이트 주기
권장:
- ingest: 매일
- lint: 주 1회
- 회고: 주 1회
주기를 정하지 않으면 “시간날 때 하자”가 되고, 거의 실패합니다.
2. 폴더 구조는 이렇게 고정하면 된다
kb/
raw/
docs/
meetings/
links/
assets/
wiki/
concepts/
entities/
playbooks/
decisions/
outputs/
reports/
slides/
charts/
index.md
log.md
RULES.md
raw/
원문 보관소입니다. 절대 수정하지 않습니다.
wiki/
LLM이 유지하는 지식층입니다. 요약/비교/런북/개념 연결은 여기서 처리합니다.
outputs/
질의 결과물을 둡니다. 좋은 결과는 다시 wiki로 승격시킵니다.
RULES.md
LLM에게 줄 운영 규칙 문서입니다. 이 파일 품질이 전체 품질을 좌우합니다.
3. RULES.md에 꼭 들어가야 할 내용
필수 항목만 정리합니다.
- raw는 수정 금지
- ingest 시 index/log 반드시 업데이트
- 신규 페이지 생성 시 관련 페이지 2개 이상 링크
- 기존 주장과 충돌하면 삭제하지 말고 “충돌 섹션”에 표시
- 질의 결과가 재사용 가치 있으면 wiki로 파일링
- 긴 문서는 1문서 1논점 원칙으로 분할
이 6가지만 넣어도 LLM의 동작이 안정됩니다.
4. ingest는 이렇게 지시하면 품질이 올라간다
나쁜 지시:
- “이 문서 요약해줘”
좋은 지시:
- “raw/docs/payment-retry.md ingest해.
- 7줄 요약 생성
- concepts/payment-reliability.md 업데이트
- playbooks/oncall-payment.md에 대응 단계 반영
- index/log 업데이트
- 기존 내용과 충돌 1개 이상 있으면 표시”
핵심은 “출력 파일까지 명시”하는 겁니다. 그래야 결과가 일회성 답변으로 끝나지 않습니다.
5. 질의를 문서로 바꾸는 습관이 핵심이다
KB를 쓰는 목적은 답변을 빨리 받는 게 아닙니다. 다음 답변이 더 빨라지는 구조를 만드는 겁니다.
예시:
- 질문: “결제 실패 재시도 전략, 우리 시스템에서 뭐가 맞나?”
- 산출: outputs/reports/payment-retry-options.md
- 승격: wiki/decisions/decision-2026-04-payment-retry.md
이걸 반복하면 팀 의사결정 히스토리가 쌓입니다. 신규 인력도 문서만 따라가면 맥락을 이해할 수 있습니다.
6. 주 1회 lint 체크리스트
아래 5개는 자동 점검 대상입니다.
- 동일 개념이 다른 페이지에서 다르게 정의됨
- 30일 이상 갱신 없는 핵심 페이지
- 링크가 하나도 없는 고아 페이지
- 인덱스에는 있는데 실제 파일이 없음
- 이미 폐기된 결론이 최신 결론처럼 남아 있음
lint는 “청소”가 아니라 “품질 유지”입니다. 이걸 안 하면 4주 안에 신뢰도가 떨어집니다.
결론
LLM Knowledge Base는 툴보다 운영 규칙이 먼저입니다.
- 폴더 구조를 단순하게 고정하고
- RULES.md를 명확히 만들고
- ingest/query/lint 루프를 주기로 돌리면
문서는 쌓이기만 하는 자산이 아니라, 팀의 실행 속도를 올리는 엔진이 됩니다.
다음 액션은 하나면 충분합니다.
오늘 kb/ 폴더와 RULES.md를 만들고, 핵심 문서 10개만 넣어보세요.
그게 시작점입니다.