zindex - diagrams your AI agents can maintain

2 min read Original article ↗

agent-native diagram state infrastructure

Zindex is a stateful diagram runtime for agents. Create architecture diagrams, ERDs, workflows, sequence diagrams, org charts, and topology maps from structured data - then patch, validate, diff, and render them as systems change.

Not a whiteboard. Not a Mermaid clone. A database-like backend for diagrams with stable IDs, typed operations, semantic validation, immutable revisions, auto-layout, and SVG/PNG rendering.

zindex architecture

agent DSP zindex validate normalize scene layout render SVG PNG

01

Keep diagrams in sync with reality

Agents update existing diagrams from codebases, schemas, APIs, tickets, HR data, or infrastructure - without redrawing from scratch.

02

Make diagram changes reviewable

Every edit creates an immutable revision. Diff diagrams by scene structure, not pixels.

03

Catch broken diagrams before they ship

Validation catches missing endpoints, invalid references, bad containment, layout issues, and family-specific mistakes.

04

Let agents describe structure, not pixels

Agents define nodes, edges, relationships, and constraints. Zindex handles layout, routing, labels, and rendering.

05

Render anywhere

One canonical scene can become SVG or PNG across themes without changing the underlying state.

agents / LLMs decide what should change

zindex apply changes through DSP protocol

renderers display the result

A database for diagrams.

Store the diagram once. Patch it with operations. Validate every change. Render any revision.

{
  "schemaVersion": "0.1",
  "diagramFamily": "architecture",
  "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.