Archify:把真實程式庫架構編譯成可互動、可驗證的單檔 HTML 系統地圖
tt-a1i/archify 是給 Cursor、Claude Code、Codex CLI 與 OpenCode 使用的 Agent Skill:AI 先讀 repo 或系統描述,產生 typed JSON IR,再由零相依 renderer 與驗證器編譯成可互動的單檔 HTML/SVG。支援 Architecture、Workflow、Sequence、Data Flow、Lifecycle 五種圖,以及 PNG/SVG/WebM/Share Card 匯出。實測 doctor、demo 與四個桌面尺寸的 visual-check 全部通過,暗色 demo 視覺清晰;但圖的「真實性」仍取決於 agent 讀取範圍與 JSON 中被 authored 的事實,不是 live infrastructure discovery。
Developer Tool / Agent Skill / Architecture Visualization
Archify 把「請 AI 畫一下這個 repo」從一次性 Mermaid 圖,提升成一個可版本化的產物:typed JSON IR+deterministic validators+interactive standalone HTML。輸出的節點可搜尋、可追上下游、可查最短 authored route、可切換主題與視覺 preset,也能產生架構變更前後對照。
核心流程
Repository/系統描述/Mermaid input
│
▼
Agent 讀取真實程式與需求
│
▼
Typed JSON IR
├─ nodes / relationships
├─ boundaries / lanes / states
├─ stable IDs / source evidence
└─ deliberate layout coordinates
│
▼
Schema+composition+route validators
│
▼
Deterministic renderer
│
├─ Standalone interactive HTML/SVG
├─ PNG / JPEG / WebP / SVG
├─ WebM finite motion
└─ 1200×630 Share Cards
五種圖,不只 Architecture
| 類型 | 最適合說明 |
|---|---|
| Architecture | 元件、服務、儲存、雲端/網路/安全邊界、owner 與部署區域。 |
| Workflow | CI/CD、審批、runbook、agent tool calls、分支與例外。 |