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

  1. diagram が答える question、audience、decision / explanation の目的を一文で固定する。
  2. 必要な abstraction level と diagram type を選び、1枚にすべての detail を詰めない。
  3. 下記 reference を開き、node / connector / grouping / label / legend / progressive disclosure を比較する。
  4. visual difference を semantic difference に対応させ、同じ意味には同じ表現を使う。
  5. layout を flow と relationship に従って整理し、crossing / ambiguity / unlabeled relation を減らす。
  6. final render と text alternative の両方で理解可能か検証する。

Observe

Installs
3
GitHub Stars
1
First Seen
Sep 27, 2026