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해.
1. 7줄 요약 생성
2. concepts/payment-reliability.md 업데이트
3. playbooks/oncall-payment.md에 대응 단계 반영
4. index/log 업데이트
5. 기존 내용과 충돌 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개만 넣어보세요. 그게 시작점입니다.