← ClaudeAtlas

zzon-doclisted

코드베이스나 설명을 분석해 아키텍처/인프라/ERD/Claude 에이전트 다이어그램을 그린다. 동봉 엔진(TS DSL → 자동배치 → 셀프컨테인드 인터랙티브 .html)으로 렌더한다. "아키텍처 그려줘", "인프라 다이어그램", "ERD 만들어줘", "이 시스템 구조를 시각화" 같은 요청에 사��한���.
HOKlNG/zzon-doc · ★ 2 · Data & Documents · score 73
Install: claude install-skill HOKlNG/zzon-doc
# 아키텍처 다이어그램 그리기 코드를 분석해 **엔진 DSL**(`.ts`)을 저작하고 동봉 엔진(`${CLAUDE_PLUGIN_ROOT}/engine`, bun+TS)으로 의존성 0짜리 단일 `.html`을 만든다. 여러 장이면 `build-docs.mjs`로 통합 문서에 묶는다. > 엔진은 진짜 자동 배치(ELK+격자+직교 라우팅)라 **lane/order 수동 조정과 layout-lint가 없다** — > 대신 렌더 후 불변식 검사(겹침·관통·라벨 충돌 0)를 통과시킨다. > 시간축 왕복(요청/응답·alt/loop)은 여전히 **zzon-seq** 스킬이다. Terraform 클라우드 인프라(프로바이더 무관)는 **terra-form** 스킬이 전문이다. ## 1. 범위를 먼저 잡는다 (가장 중요 — 기존 게이트 유지) - **구체적 요청** → 바로 그 한 장. - **포괄적 요청** → **① 구조·개수 파악 → ② "문서 목록+장수+뎁스" 제안·승인(3택: 개괄/사다리 세트/풀뎁스 원장) → ③ 작성.** 승인 없이 그리지 마라. 큰 프로젝트는 기능·도메인별로 쪼갠다(한 장 ~13노드 내외 권장, 원장은 예외). ## 2. 유형 판별 → 저작 방식 **어휘 결정 규칙(정책)** — 판별 후 가장 먼저 정한다: - **IaC(Terraform 등) 기반 클라우드/네트워크 아키텍처** → 해당 클라우드 공식 아이콘 (terra-form 절차, 레거시 스펙이면 `"vocabulary": "aws"`) - **프로젝트 단위·C4 레이어(컨텍스트/컨테이너/컴포넌트/MSA/도메인)** → 기존 카테고리 카드 - 한 장 안에서 혼용 금지(validator가 막는다) — 하이브리드는 `allowMixedVocabulary` 명시 시에만 | 유형 | 저작 | |---|---| | A 개요(컨텍스트·랜드스케이프), B 구조 중 C4/MSA/도메인 | **카테고리 카드 노드**(`category:`/`tech:`/`description:`, AWS 아이콘 금지 관례) — 참고: `engine/examples/msa-sample.ts` | | B 구조 중 클라우드/멀티리전/EKS/계정위계/네트워크 | **AWS 아이콘 + grid/overlay/band** — 참고: `engine/examples/serverless-sample.ts`, `eks-cluster.ts`, `multi-account-lz.ts`, `multi-region-cicd.ts`. tf가 있으면(클라우드 무관) terra-form 스킬 절차로 | | C 흐름(기능·이벤트·CI/CD) | 구조 + **`d.flow()`**(엣지 순번+내레이션, 뷰어에서 클릭 하이라이트), `docKind:"data-flow"` | | D ERD | **`table:` 노드** + `sourceColumn/targetColumn` + 카디널리티, `docKind:"erd"` — 참고: `engine/examples/erd-sample.ts` | | 시퀀스 | zzon-seq로 위임