Diagrams
Every diagram on this site is a standalone HTML document generated from a small JSON specification with archify. Open one full screen and it brings its own toolbar: pan and zoom, search, relationship tracing, semantic views, a light/dark switch, and PNG/SVG export.
| Diagram | Type | Page | Specification |
|---|---|---|---|
| Delivery platform | architecture | Delivery Platform | diagrams/delivery-platform.architecture.json |
| Pull request to production | workflow | PR to Production | diagrams/pr-to-production.workflow.json |
| Deploy request | sequence | Deploy Request | diagrams/deploy-request.sequence.json |
| Product event pipeline | dataflow | Product Events | diagrams/product-events.dataflow.json |
| Feature rollout lifecycle | lifecycle | Feature Rollout | diagrams/feature-rollout.lifecycle.json |
Changing a diagram
The rendered HTML is committed so the site builds without a diagram toolchain, but the JSON specification is the source of truth. To change one, edit the JSON and re-render:
./scripts/render-diagrams.shThe script uses the archify skill vendored at .claude/skills/archify/ and requires
only Node 18+. Every diagram is rendered with the showcase quality profile, which
fails the build on overlapping labels, ambiguous routing, or unreadable text at desktop
widths — so a diagram that renders is a diagram that has been geometrically checked.