init: company-haness 설계

2026-07-23 17:49:00 +09:00
parent 57d1bab894
commit f668d6a158
962 changed files with 98989 additions and 1 deletions
@@ -0,0 +1,49 @@
+---
+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/