contract / schema
README
wiki2
LLM이 유지보수하는 혼합 지식 도서관.
읽기 순서 (계약이 먼저)
- ontology.md — 분류 계약 (축·닫힌 집합·불변식)
- AGENTS.md — ingest / query / lint 운영 계약
- index.md — 페이지 카탈로그
- log.md — 시간순 운영 기록
- raw/README.md — 원본 층
- wiki/README.md — 위키 층
세 계층
| 층 | 경로 | 역할 |
|---|---|---|
| 온톨로지·운영 (schema) | ontology.md, AGENTS.md, index.md, log.md |
계약과 항해 |
| raw | raw/ |
불변 원본 |
| wiki | wiki/ |
LLM이 쓰는 누적 지식 |
분류 좌표(corpus/origin/layer/type/domain/…)는 폴더가 아니라 frontmatter에 있다.
폴더를 늘려 축을 복제하지 않는다.
토폴로지 (현재)
wiki2/
README.md ← 진입점
ontology.md ← 분류 계약 owner
AGENTS.md ← 운영 계약
index.md
log.md
raw/
README.md
inbox/ ← 미처리 투척
imports/ ← ingest 확정 원본
assets/ ← 로컬 이미지 등
wiki/
README.md
templates/ ← type=template 페이지
*.md ← 지식 페이지 (flat)
상세 규칙: raw/README.md, wiki/README.md.
검증
python3 scripts/verify_wiki.py
ontology I1–I18, corpus×type, index 동기, log 헤더, 상대 링크, raw_source 존재 여부를 fail-fast로 검사한다.
웹 (wiki.nornen.net 교체용)
MkDocs가 아닌 Observatory 정적 UI (web/ + scripts/build_web_site.py).
make site-build # → site/
make site-serve # http://127.0.0.1:8765
# 배포 (운영 키/호스트 필요)
python3 scripts/oci_deploy_static_site.py --host opc@HOST --ssh-key ~/.ssh/KEY
설계 요지: 좌측 문서 트리 대신 corpus/layer/type/domain/project 좌표 필터 + 프로젝트 성좌 + 리더 옆 궤도 패널.