example.scene.json
{
"schemaVersion": "0.1",
"scene": {
"id": "payments-arch",
"units": "px"
},
"elements": [
{
"id": "api",
"kind": "node",
"nodeType": "service",
"shape": "roundedRect",
"label": "API Gateway"
},
{
"id": "queue",
"kind": "node",
"nodeType": "queue",
"label": "Job Queue"
},
{
"id": "e1",
"kind": "edge",
"from": { "elementId": "api" },
"to": { "elementId": "queue" },
"router": "orthogonal"
}
]
} Semantic, not geometric
Agents declare nodes, edges, and relationships. Layout is computed, not hand-placed.
Layout engine built in
A Sugiyama-style hierarchical layout pipeline figures out positions, edge routes, and label placement automatically. Agents describe the graph; the engine handles the geometry.
Patchable
Stable IDs enable incremental updates. Add a node, move an edge - without regenerating the entire diagram.
Renderer-agnostic
One canonical scene, multiple outputs: SVG and PNG with 4 render themes (clean, dark, blueprint, sketch).
Deterministic
Same input, same output. Validate → normalize → layout → render. Every step is inspectable.