design-diagram-architecture
Authors a house-style inline-SVG architecture diagram for a Tutti design page. Use during the Structure movement to show the system's shape as nested C4-ish zones (a context holding containers, a cont
SKILL.mdskills/design/diagrams/architecture/SKILL.md
GitHubArchitecture diagram
Draw the system's structure as nested boundaries: an outer context zone that holds one or two container nodes, each a real deployable piece. This is the C4-ish view, boxes inside boxes.
Vocabulary
Use the shared Sotto classes so the diagram matches the design page:
- Boundaries:
<rect class="svg-zone">with an uppercase<text class="zonelabel">(a system context, a container). Nest a smaller zone inside a larger one for a container-holds-components view. - Containers and components:
<rect class="svg-node" ...>with a<text class="nodetext">name and an optional<text class="nodesub">role ("FastAPI", "Rust"). - Relations: a
<line>or<path>in an accent stroke with an arrowhead when one piece calls another, with an optional<text class="flowlbl">. - Accents carry meaning: amber
#ffb454for the subject system, teal#5fd3c4for a trusted or safe container, muted#97a0abfor boundaries and context.
How to lay it out
Draw the outer zone first, then place the containers inside with room around them. Nest at most two levels; a diagram that shows every class is a call graph, not an architecture. Label each zone in uppercase.
Output
Emit a single <svg viewBox="0 0 W H">...</svg> and nothing else. It must be well-formed
(balanced or self-closing tags, quoted attributes, no XML comments). See example.svg in this
skill for a complete, valid reference.