Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
docs(skill): spell out first-draft field shapes for sequence, dataflow, class, timeline
tt-a1id5335aa548cf
diff --git a/archify/references/authoring-contract.md b/archify/references/authoring-contract.mdindex 195202a3..cb977cda 100644--- a/archify/references/authoring-contract.md+++ b/archify/references/authoring-contract.md@@ -318,10 +318,14 @@ not settle viewport fit. These are repair directions, not guaranteed coordinatesParticipants are ordered by conversation role. Messages own their vertical order. Use return/async/security variants for meaning, not decoration; sequence does not use Automatic Port Spread. A segment's `from`/`to` edges must stay at least 4px off every message arrow (`message.y`): an edge along an arrow leaves the reader unable to tell which phase the message belongs to, and the renderer reports it.+First-draft shape: every message needs an `id`, `from`, `to`, `label`, and integer `y` at least 160. Optional phase bands are `segments[]` with only `from`, `to`, and `label` (no segment `id`). Inventing `pos`/`size` on participants fails schema validation — order alone places them.+### DataflowStages express transformation or custody. Rows separate parallel streams. Label only data contracts, classifications, or cross-boundary movement that is not obvious.+First-draft shape: declare `stages[]` (each a `{label}`), then place every node with integer `stage` and `row` — not `pos`/`size`. Flows are `flows[]` with `from`, `to`, and optional `label`.+Omit `meta.viewBox` to fit canvas width to all stages and nodes in either qualityprofile, including explicit node widths. The 940px minimum and 24px right paddingremain; left-edge overflow still needs a node repair. An authored viewBox stays@@ -447,6 +451,11 @@ with a single triangle. Members never truncate: a type grows to its widestmember up to `layout.typeMaxW` and longer members wrap at parameter boundaries.See [`../renderers/class/README.md`](../renderers/class/README.md).+First-draft shape: types use `row`/`col` (not `pos`/`size`), fields go in+`attributes[]`, operations in `methods[]` with `parameters` as one string such as+`"msg: Message"` (not an array of objects). Enum members are attributes with only+`name`. Relationships need an `id`, `from`, `to`, and `kind`.+### TimelineA timeline answers "when did what happen, and how far apart?". Every event@@ -459,7 +468,8 @@ invented or approximate times as observed, and never fill gaps with events theinput does not contain.Use `lanes` for sources or categories (release, monitoring, response); every-event then names one. `kind` (`default`, `change`, `alert`, `action`, `recovery`) only+event then names one. Each event's visible text is `title` (not `label`). `kind`+(`default`, `change`, `alert`, `action`, `recovery`) onlycolours the card; inventing values such as `milestone` fails schema validation. Events are drawn in time order whatever the authored order;simultaneous and close events stack. By default a quiet period longer than 8×the median gap and 10% of the span is drawn as a fixed-width break labelled