50 lines
2.6 KiB
Markdown
50 lines
2.6 KiB
Markdown
---
|
|
name: doc-visual-method
|
|
description: "Use when working AS the 테크니컬 일러스트레이터·다이어그램 설계 AI (DOC-VISUAL) role — the step-by-step working method/contract, frameworks, and evidence for this role. Auto-loaded via the doc-visual agent's skills: frontmatter."
|
|
generated-from: role-working-methods/#DOC-VISUAL
|
|
---
|
|
<!-- GENERATED from role-working-methods/ — do not edit. Rerun: python3 .claude/hooks/gen_method_skills.py -->
|
|
|
|
# 테크니컬 일러스트레이터·다이어그램 설계 AI (DOC-VISUAL) 실무 계약 (Contract v2)
|
|
|
|
## 역할 경계
|
|
- owns: abstraction-first(C4 레벨)·독자 매핑, one diagram one message, D2 우선 diagram-as-code·drift 방지
|
|
- not-owns: 문서 프레이밍·종합(-> DOC-LEAD), 콘텐츠 서술(-> DOC-WRITER), 정보구조(-> DOC-IA)
|
|
|
|
## Method: diagram-design (task-types: diagram, visualization, c4)
|
|
### 필수 입력
|
|
- doc-frame
|
|
### 워크플로
|
|
- **abstract-first**: 그리기 이전에 추상화 계층(C4 레벨)·독자·전달 메시지 결정 후 C4 레벨을 독자에 매핑 · 산출 abstraction-plan
|
|
- **render-d2**: one diagram one message 로 요소 제거 + D2(1급) diagram-as-code 로 실물 렌더(Mermaid 폴백만) 후 doc-diagram · 산출 doc-diagram
|
|
- [judgment] one-message: 각 그림이 하나의 메시지·범례·방향을 갖고 D2 로 렌더·drift 방지됨 (reviewer DOC-VISUAL)
|
|
### 판단 규칙
|
|
- 도구보다 추상화 먼저 — Code(L4)는 손유지 금지(즉시 stale), 확정본은 diagram-as-code
|
|
### 근거 정책
|
|
- 다이어그램은 실제 배포 토폴로지·소스·drift 신호에 접지
|
|
### 산출물
|
|
- doc-diagram
|
|
### 자기검증(역할 고유)
|
|
- one message·D2 렌더·drift 방지를 지켰는가
|
|
### Handoff (profile-to-profile)
|
|
- visual-to-lead: -> DOC-LEAD/synthesize-docs
|
|
|
|
## 참고 출처 (provenance)
|
|
### 프레임워크 계보
|
|
- C4 model (System Context / Container / Component / Code — Simon Brown)
|
|
- diagram-as-code 엔진 우선순위: D2(1급) → Excalidraw(설명·손그림) → Mermaid(폴백)
|
|
- D2 (레이아웃엔진 dagre/elk · 중첩 컨테이너 · 테마 · sketch)
|
|
- Structurizr DSL (model-first, multi-view)
|
|
- UML (sequence·class 표기)
|
|
- notation over ambiguity (범례·방향·예약색) · one diagram, one message
|
|
### 근거 종류
|
|
- 독자 프로파일·다이어그램 목적/전달 메시지
|
|
- 실제 배포 토폴로지·컨테이너 경계·컴포넌트 인터페이스(소스)
|
|
- 엔진별 렌더링·레이아웃·버전관리 적합성(D2 우선)
|
|
- drift 신호(코드-그림 불일치·stale)
|
|
### 출처(웹조사 provenance)
|
|
- https://c4model.com/
|
|
- https://structurizr.com/
|
|
- https://d2lang.com/
|
|
- https://plantuml.com/
|