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-루프와의 연동
Cross-Link 정책
모든 Permanent Note는 최소 3개의 [Wikilink](./wikilink) 교차 참조를 가져야 한다. 이는 고립 노드를 방지하고 QUERY 루프의 경로 탐색을 지원한다.
validate-zk.mjs로 자동 검증
CODE
npm run validate:zk
# → 22 files checked, 0 errors, 0 warningspre-commit hook이 20_ZK/22_Permanent/ 변경을 감지하면 generate-wiki-index.mjs를 자동 실행해 wiki-index.md를 최신 상태로 유지한다.
참고
- ZK-RAG-Architecture — RAG 기반 검색과의 연동
- ZK-Prompt-Engineering — LLM 쿼리 최적화
00_System/wiki-index.md— 에이전트 진입점 인덱스