Files
settled-reach/docs/design/diagram-wireframe-conventions.md
T
jpmschweitzerandClaude Fable 5 6c078fbec4 fix(meta): PR #175 review round — all 14 findings addressed
H1 godot-cold-parse exit-code guard (+bonus: import-pass for cold checkouts, found live); H2 pr-watchlist-diff loud registry failure; H3/T1 deny list :* normalization (add-only) + uniform allow syntax; H4/T7 helper-script allows; H5 get_api_key env-only (config.json is tracked — no secret fallback); H6 TEAM.md active/standby split; H7 troblum solo-profiling note; H8 pr-review frontmatter Task->Agent; H9 conventions doc taxonomies fixed vs real tree; T2 ask-gate leash files (settings/hooks) in tracked settings; T3 R-013 cross-reference; T4 governance README index regenerated (pql decisions sync); T5 dudley briefing ACTIVE; T6 pr-process step 7 run-from-main.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 22:11:36 +02:00

31 lines
1.5 KiB
Markdown

# 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.