zzon-wikilisted

# 프로젝트 문서 위키 만들기 코드/인터뷰에서 **wiki.json**(단일 상태 소스)과 **docs/*.md**를 저작하고 `scripts/build-wiki.mjs`로 의존성 0짜리 self-contained 위키 사이트(index.html)를 만든다. 산출물은 `zzon-doc/` 하위에 기존 다이어그램 산출물과 공존한다. > 계약 정본: `references/wiki-spec.md`(스키마·md 규약) · `references/doc-catalog.md`(문서 카탈로그·질문 은행). > 아키텍처·데이터 다이어그램은 **zzon-doc 스킬 절차**(유형 판별→스펙→layout-lint→render)로, > 시간축 상호작용(요청/응답 왕복·분기)은 **zzon-seq 스킬 절차**(SeqSpec 저작→render-seq)로 그린다. > 둘 다 같은 specs/→diagrams/→manifest 파이프라인이라 위키 임베드 방법(`@diagram`)은 동일하다. ## 0. 분기 — 첫 행동을 정한다 - `zzon-doc/wiki.json`이 **있으면 → 재진입 모드(§4)**. 첫 행동은 무조건 `--status` 실행이다. - 없으면 → 신규. 코드가 있는 프로젝트면 `projectMode: "existing"`(스캔 우선), 빈/초기 프로젝트면 `"greenfield"`(인터뷰 우선). - 기존 `zzon-doc/manifest.json`(다이어그램)이 있으면 → 승격: 기존 다이어그램을 아키텍처/데이터 문서로 **자동 편입 제안**에 포함한다. ## 1. 스캔 → 제안 → 승인 (게이트 — 어기지 마라) **순서를 반드시 지킨다: ① 스캔 → ② "티어·섹션" 제안·승인 → ③ 작성.** **승인 전에는 wiki.json도 docs/의 어떤 파일도 만들지 마라.** 1. **스캔**: README·패키지 구조·라우터·스키마·CI/IaC를 훑어 **"코드에서 읽힌 것"과 "물어야 하는 것"을 분리**한다. (greenfield면 이 단계는 "무엇을 만들려는지" 인터뷰 3~5문으로 대체.) 2. **제안은 반드시 이 형태로** — 티어 3택 + 제외 섹션 + 개수 근거 (**시퀀스 후보�� 반드시 센다** — 인증·결제·대표 유스케이스처럼 왕복이 본질인 프로세스는 "시퀀스 M장"으로 제안에 명시): > "코드에서 서비스 3·테이블 12·API 24개, 시퀀스 후보 3(인증·공유·다이제스트)을 확인했다. 어느 티어로 갈까? > **① 라이트(~15장)** — 개요+아키텍처+데이터+API+퀵스타트+운영 핵심 > **② 표준(~35장)** — ①에 요구·기획·규약·운영 상세 추가 > **③ 풀 SI(~90장)** — 발주·감리용 전체 > 그리고 UX 섹션은 Figma 관리로 보여 제외를 제안한다 — 맞나?" 3. 승인받은 구성으로 **wiki.json을 인스턴스화**한다(카탈로그는 템플릿 — `doc-catalog.md`의 인스턴스화 절차 6개를 따른다. dynamic 노드는 실제 도메인명으로,