wiki2 observatory nornen knowledge atlas

contract / schema

README

wiki2

LLM이 유지보수하는 혼합 지식 도서관.

읽기 순서 (계약이 먼저)

  1. ontology.md — 분류 계약 (축·닫힌 집합·불변식)
  2. AGENTS.md — ingest / query / lint 운영 계약
  3. index.md — 페이지 카탈로그
  4. log.md — 시간순 운영 기록
  5. raw/README.md — 원본 층
  6. 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 좌표 필터 + 프로젝트 성좌 + 리더 옆 궤도 패널.