Archify
An agent skill that produces five families of diagrams from a repository: architecture, workflow, sequence, data flow, lifecycle. The agent is not allowed to draw: it emits a typed JSON graph that a local compiler validates, then turns into self-contained HTML with PNG export. A diagram failing validation does not replace the last one that passed.
Strengths
- The agent emits a typed JSON graph, not a drawing: five checks must pass before a diagram replaces the previous one
- Nodes cite their sources (`SRC n`) pointing at a file and a line range pinned to a commit
- A validation failure returns actionable repair guidance instead of a plain retry
- Before / after comparison of two validated snapshots, with a receipt of what moved in the structure
- Self-contained HTML output with PNG export, readable with no server and no build, under the MIT licence
Limitations
- A verifiable diagram is not a correct diagram: validation proves graph consistency, not the relevance of the breakdown
- The before / after comparison says nothing about execution or merge safety, only about the graph
- A very young repository, with no release history, and an integration requiring Node 22.19 or 24 depending on the host
Best for
- Documenting the architecture of a repository you are taking over, with diagrams that cite their lines of code
- Showing in code review what the change moved in the structure, before and after
- Producing a sequence or data-flow diagram without letting the agent invent components