Archify

Agent skill → JSON IR → typed renderers → standalone HTML

Archify Agent skill → JSON IR → typed renderers → standalone HTML archify/ skill package You · NL or Mermaid · Architecture component You NL or Mermaid Agent Hosts · Claude · Codex · opencode · Architecture component Agent Hosts Claude · Codex · opencode SKILL.md · layout judgment · Architecture component · prompt dialect SKILL.md layout judgment prompt dialect JSON IR · schema_version: 1 · archify/ skill package JSON IR schema_version: 1 JSON Schema · ajv strict · archify/ skill package · fail-closed JSON Schema ajv strict fail-closed Renderers ×5 · layout checks · archify/ skill package · no auto-layout Renderers ×5 layout checks no auto-layout template.html · theme + export · archify/ skill package template.html theme + export Output Check · SVG gates · archify/ skill package Output Check SVG gates HTML Artifact · single file · Architecture component HTML Artifact single file archify.zip · skill package · Architecture component archify.zip skill package CI Gates · golden + zip · Architecture component CI Gates golden + zip write IR deliver Legend External Frontend Message bus Security Backend Cloud

Agent loop

  • • Claude / Codex / opencode load the skill
  • • SKILL.md teaches layout judgment, not auto-layout
  • • Mermaid is an input dialect via prompt, not a parser

Render path

  • • JSON IR pins schema_version: 1
  • • Five typed renderers: architecture / workflow / sequence / dataflow / lifecycle
  • • template.html owns theme toggle and 4× export

Quality gates

  • • ajv schema validation sits on the IR (fail-closed)
  • • Renderer layout checks, then Output Check on the HTML
  • • CI golden tests and zip freshness stay off the main path

Architecture diagram • Built with Archify • Create yours ↗ • Hover to trace • R route • Click to focus • +/− zoom • M radar • T theme • E export