LLM 위키 구축 실용 팁 모음

팁 1: 클리핑은 ‘원자적’으로

하나의 클리핑 파일에는 하나의 개념만 담아라. LLM이 여러 개념을 혼합하면 노트의 경계가 모호해진다. 예: “함수형 프로그래밍과 비동기 처리”를 하나의 클리핑으로 만들지 말고, 각각 분리하라.

팁 2: 프론트매터의 힘

tags, created, updated 필드를 반드시 채워라. LLM이 검색하고 연결할 때 이 메타데이터가 필터 역할을 한다. 예를 들어 tags: [버그, 성능] 같은 태그는 LLM이 유사한 이슈를 찾는 데 결정적이다.

팁 3: 위키링크는 ‘생략’의 미학

[[20260615-github-llm-wiki|github-llm-wiki-철학]]처럼 간결하게 써라. [[20260615-github-llm-wiki|github-llm-wiki-철학]]처럼 경로를 포함하면 LLM이 노트 간 관계를 추론할 때 노이즈가 된다. 순수 슬러그가 최적이다.

팁 4: R3(Reweave) 단계를 무시하지 마라

이 단계에서 LLM은 기존 노트와 새로운 클리핑 사이의 비약적 연결을 시도한다. 이때 나오는 결과물이 가장 창의적이다. 예: “이 버그 수정이 왜 3년 전 아키텍처 결정과 관련이 있을까?”라는 질문을 LLM에 던져보라.

팁 5: CI/CD에 검증 파이프라인 포함

모든 PR이 머지되기 전에 R5(Verify) 단계를 CI에서 실행하라. 깨진 위키링크, 누락된 프론트매터, 포맷 오류를 자동으로 잡아낸다. GitHub Actions와 통합하면 완벽하다.

연결