콘텐츠로 바로가기

Zettelkasten Permanent Note 시스템: LLM 지식 베이스 설계

Permanent Note의 메타데이터 설계와 LLM-WIKI 연동 구조를 정리한다.

sys.entry
M

Me

hyunyoun's Blog

concept2 min read

🧠 오늘 배운 것

Zettelkasten의 Permanent Note는 단순한 요약이 아니라 원자적 개념(atomic concept) 을 담는 독립 단위다. LLM이 검색·인용하는 지식 베이스로 활용하려면 구조화된 메타데이터가 핵심이다.

핵심 메타데이터 구조

CODE
---
type: permanent
status: active
zk_stage: seedling # seedling → growing → evergreen
domain: "machine-learning"
topic: ["llm", "rag"] # 배열 필수
authored_by: llm # llm | co-authored | human
ingested_at: "2026-04-20T00:00:00Z"
---

zk_stage는 노트의 성숙도를 추적한다. seedling은 초기 초안, evergreen은 반복 검토를 거쳐 안정화된 상태다.

LLM-WIKI 4-루프와의 연동

루프 역할
INGEST 외부 지식 → Literature Note → Permanent Note
QUERY wiki-index 스캔 → Permanent Note 읽기 → 답변
LINT 고아 노트·broken link·outlinks < 3 탐지
PUBLISH Permanent Note → content/posts 발행

모든 Permanent Note는 최소 3개의 [Wikilink](./wikilink) 교차 참조를 가져야 한다. 이는 고립 노드를 방지하고 QUERY 루프의 경로 탐색을 지원한다.

validate-zk.mjs로 자동 검증

CODE
npm run validate:zk
# → 22 files checked, 0 errors, 0 warnings

pre-commit hook이 20_ZK/22_Permanent/ 변경을 감지하면 generate-wiki-index.mjs를 자동 실행해 wiki-index.md를 최신 상태로 유지한다.

참고