원자료를 보관하면서 LLM이 참고할 요약도 만들고 싶은데, 어디까지 옮겨야 할지 막막한가요? 이 볼트의 운영 계약은 원자료를 담는 raw, 에이전트가 유지하는 합성 지식인 wiki, 편집 규칙을 담는 schema로 역할을 나눕니다. 이 글은 그 계약과 작업 일지를 바탕으로 자료를 보존하고, wiki에 반영하고, 변경을 기록하는 기준을 정리합니다.

이 볼트의 운영 원칙은 raw에 상세 원자료를 두고, wiki에는 압축한 지식과 원자료로 돌아가는 링크를 유지하는 것입니다.

raw·wiki·schema의 역할 나누기

LLM Wiki 개념 노트는 에이전트가 원문을 반복해서 재발견하는 대신, 구조화된 마크다운 위키를 유지하는 패턴으로 설명합니다. 이 볼트의 운영 계약은 그 역할을 다음과 같이 나누고, 비활성 자료를 위한 archive를 별도로 둡니다. 2026-05-22 작업 일지에는 원자료와 합성 페이지, 비활성 자료를 각 계층으로 옮기고 스키마·인덱스·로그를 추가한 기록이 있습니다.

계층운영 계약에 정해진 역할
raw원문, 관찰, 작업 메모, 예시 등을 담는 상세 지식 창고
wiki에이전트가 유지하는 압축된 합성 지식, 교차 연결, 재사용 가능한 규칙
schema위키를 유지하기 위한 규칙, 템플릿, 편집 관례
archive비활성 상태이거나 다른 자료로 대체된 자료

raw 운영 규칙은 자연스러운 산문, 표, 예시, 질문, 개념 조각을 허용하며 인용 우선의 형식을 강제하지 않습니다. 다만 외부 출처가 있는 자료는 추출 가능한 범위에서 원문의 표현과 구조를 보존하도록 정합니다. 개인 해석이나 질문, 정정은 원문과 구분된 절에 적는 것이 계약의 기준입니다.

원자료 보관을 상징하는 이미지: 손이 빛나는 메모 카드를 디지털 아카이브 선반에 꽂는 모습
raw의 원자료 보관 역할을 표현한 개념 이미지이며, 실제 볼트 화면이나 작업 기록은 아닙니다.

새 자료를 들일 때 적용하는 순서

운영 계약은 볼트에서 답할 때 wiki 인덱스를 먼저 읽도록 정합니다. 외부 자료를 추가할 때는 링크만 남기지 않고, 가능한 원문 내용을 raw의 마크다운 노트로 옮기도록 합니다. 아래는 계약에 적힌 작업을 자료 반영 순서로 정리한 절차입니다.

  1. wiki 인덱스를 먼저 읽어 관련 지식의 위치를 확인합니다.
  2. 외부 자료의 본문을 기술적으로 가능하고 허용되는 범위에서 raw에 옮깁니다.
  3. 관련 자료를 부모 인덱스나 로컬 허브로 묶고, 큰 자료는 집중된 자식 노트로 나눕니다.
  4. wiki 반영 기준에 해당하는 내용을 합성하고, 상세 원자료로 돌아가는 링크를 둡니다.
  5. wiki 편집 내용을 인덱스에 반영합니다.
  6. 자료 반영이나 구조 변경 내용을 작업 로그에 덧붙입니다.
raw, wiki, schema, archive 네 계층의 역할과 새 자료를 들일 때 wiki 인덱스 확인에서 작업 로그 기록까지 여섯 단계가 이어지는 순서를 나타낸 다이어그램
표의 계층별 역할과 위 목록의 반영 순서를 한 장에 모아, 각 단계가 어느 계층의 일인지 함께 볼 수 있게 했습니다.

원문을 전부 옮길 수 없는 경우도 운영 규칙에 포함돼 있습니다. 저작권·개인정보 범위나 추출 한계로 이관이 막히면, 허용되는 내용과 옮기지 못한 범위를 raw 노트에 명시하도록 합니다. 출처 링크는 출처 확인이나 원래 배치 참조를 위해 남기되, 링크 자체를 옮겨 온 본문으로 취급하지 않는다는 기준입니다.

raw가 생겼다고 wiki 페이지를 반드시 만들지는 않는다

커버리지 점검 노트는 raw 노트의 존재만으로 wiki 페이지를 만들지 말라고 정리합니다. 그 노트가 제시한 반영 기준은 반복 조회 대상, 재사용 가능한 규칙, 여러 출처 사이의 연결, 현행 지식이나 작업 흐름의 허브입니다. 운영 계약 역시 wiki가 raw 본문 전체를 복제하지 않고, 압축한 지식과 원자료로 돌아가는 링크를 유지하도록 정합니다.

태그의 필수 계열과 허브의 구성

태그 분류 규칙은 유지 대상 노트마다 layer/*와 type/* 태그를 각각 하나 이상 요구합니다. 주제 내용이 있으면 domain/* 또는 subject/* 태그도 붙이도록 정합니다. 2026-05-22 작업 일지에는 이 계열들에 note/*와 status/*를 더한 6개 계열을 활성 노트에 적용한 기록이 있습니다.

허브에 대해서는 관련 raw 폴더와 파일을 부모 인덱스나 로컬 허브로 묶는다는 규칙이 있습니다. 폴더 인덱스 템플릿은 범위, 탐색 순서, 폴더 구성을 다음 절로 나눕니다. 큰 자료의 세부 내용은 자식 노트에 두고, 부모 노트는 탐색용 인덱스로 유지하도록 정합니다.

  • Knowledge Scope: 역할, 다루는 범위, 자료를 나누거나 묶은 기준, 마크다운 이관 상태
  • Navigation / Browsing Order: 자료를 읽거나 살펴볼 순서
  • Folder Map: 관련 폴더와 파일, 유용한 내부 링크

2026-05-29 작업 일지에는 부모 raw 노트를 짧은 탐색 인덱스로 남기고 상세 목차를 챕터 폴더로 옮긴 기록이 있습니다. 같은 날 기록에는 10개 로직 폴더를 41개 하위 노트로 재구성한 작업도 남아 있습니다. 일지는 각 로직 영역이 하나의 큰 마크다운 문서에 의존하지 않도록 구성을 바꿨다고 설명합니다.

규칙과 보정 기록을 구분해서 읽기

태그와 메타데이터 규칙 외에, 누락을 보정한 작업도 일지에 기록돼 있습니다. 2026-06-03 일지에는 aliases, date created, date modified, linter-yaml-title-alias 중 누락된 항목이 있는 raw 마크다운 2,659개를 보정했다고 적혀 있습니다. 같은 기록은 당시 raw 마크다운 5,338개를 재감사해 필수 키와 태그 계열 등의 누락이 0건이었다고 보고합니다.

wiki를 먼저 합성한 뒤 커밋하는 규칙

이 볼트의 커밋 규칙은 사용자의 명시 요청이 없으면 raw 변경을 스테이징·커밋·푸시하지 않도록 정합니다. raw 내부의 인덱스와 허브 변경도 이 범위에 포함됩니다. 2026-06-30 작업 일지에는 이 예외를 운영 계약에 추가한 기록이 있습니다.

wiki 우선 커밋 규칙은 작업이 끝났다고 바로 커밋하지 않고, 먼저 세션의 raw 변경 내용을 wiki의 압축된 합성과 원자료 링크로 반영하도록 정합니다. 커밋 범위는 wiki와 해당 작업에서 실제로 변경해야 했던 schema·운영 계약 파일입니다. wiki 편집 뒤에는 인덱스를 최신으로 유지하고, 작업 로그에 변경 기록을 덧붙이는 규칙도 함께 적용됩니다.

질문에 답할 때 찾는 순서

볼트에 질문을 던질 때는 wiki 인덱스를 먼저 읽고, 필요하면 로컬 검색으로 raw 근거를 찾습니다. 이 볼트의 검색 계약에는 bun tools/rag/cli.ts query "<질문>" --json --k 8 명령이 적혀 있습니다. 기본값은 상위 8개 결과, wiki와 raw를 함께 보는 --layer all, BM25와 벡터 검색을 합친 hybrid 방식입니다.

결과에는 계층, 경로, 제목 경로, 본문 조각, 점수가 들어 있습니다. raw 결과에는 그 노트를 링크하는 wiki 페이지를 가리키는 wiki_pointers가 붙어 있어, 원문에서 관련 wiki 요약으로 거슬러 갈 수 있습니다. 임베딩은 설정 파일에 지정한 로컬 모델을 로컬 Ollama 또는 Ollama 호환 엔드포인트로 호출하며, 계약에는 클라우드 API를 호출하지 않는다고 적혀 있습니다. 질의 캐시는 볼트 밖의 캐시 디렉터리에 만들어지고 커밋하지 않습니다.

2026-10-30에 이 볼트에서 같은 명령을 두 질문으로 읽기 실행했습니다. 대학 글쓰기 수업의 인용 질문에서는 wiki 3개와 raw 5개가 함께 나왔고, 운영 계약 질문에서는 wiki 8개만 나왔습니다. 계층 구성은 질문에 따라 달랐습니다. 검색 품질은 측정하지 않았습니다. 답변에 쓰기 전에는 결과의 원문 경로를 열어 문장을 직접 대조해야 합니다.

LLM 활용 카테고리