diagram-design
Installation
SKILL.md
Diagram Design
architecture / process / flow / hierarchy / relationship / explanatory diagram を、box と arrow の装飾ではなく特定の問いに答える visual modelとして設計する。
Mermaid / Graphviz / diagrams.net / Figma / Visio / SVG は renderer であり、diagram semantics の source of truth にはしない。
Workflow
- diagram が答える question、audience、decision / explanation の目的を一文で固定する。
- 必要な abstraction level と diagram type を選び、1枚にすべての detail を詰めない。
- 下記 reference を開き、node / connector / grouping / label / legend / progressive disclosure を比較する。
- visual difference を semantic difference に対応させ、同じ意味には同じ表現を使う。
- layout を flow と relationship に従って整理し、crossing / ambiguity / unlabeled relation を減らす。
- final render と text alternative の両方で理解可能か検証する。