# Diagram & wireframe conventions (Settled Reach)

The `/d2-diagram` and `/frame0-wireframe` skill *mechanics* now live at user scope
(`~/.claude/skills/`), de-contaminated of repo-specifics. This file preserves the
Settled-Reach tailoring the local skill copies carried, so it isn't lost when they're
deleted (CLAUDE-CLEANUP §2 / T-1101).

## d2 diagrams (`/d2-diagram`)

**Output taxonomy:** `.d2` source + `.png`/`.svg` renders under
`docs/diagrams/{category}/{name}.d2` — categories in use: `architecture/`,
`data-flow/`, `design/`, `entity/`, `state/`, `ui/`. Create/update a diagram
whenever a D-record is added or modified.

**Agent routing** (who to task with a diagram, by domain):
- **Qatux** — architecture decision records, system-overview + data-flow diagrams.
- **Tyre** — IPC bridge, ECS system flow, chunk-loading pipeline, perception internals.
- **Araminta** — UI navigation flow, screen transitions, component hierarchy.

## Frame0 wireframes (`/frame0-wireframe`)

**Output taxonomy:** wireframe JSON (source of truth) + exported PNG under
`docs/design/wireframes/{category}/{name}.json` — categories:
`character-creation/`, `dialogue/`, `hud/` (incl. the neural-insert HUD
wireframes `v01-insert-basic.json`, `v10-insert-full.json`), `menus/`,
`monologue/`, `navigator/`, `popups/`. Palette/style source is
`docs/design/visual-grammar-v01.md`.

**Agent routing:** Araminta (art direction / visual consistency) owns wireframe review;
Stig (UI dev) consumes them for implementation.