tt-a1i/archify

解決的問題

Archify 將技術描述或現有程式碼庫轉換為互動式、精緻的系統地圖。它解決了靜態、通用圖表缺乏精確性、驗證能力，以及無法追蹤複雜系統中元件間實際關係的問題。

作法

Archify 是一個為 AI 代理（如 Cursor、Claude Code 和 Codex CLI）設計的渲染與驗證系統。流程如下：

1. 產生：AI 代理根據系統描述產生帶有類型的 JSON 中間表示（IR）。
2. 驗證：系統執行內建的驗證器與佈局規則，確保 JSON 檔案正確且佈局具備決定性。
3. 預覽／交付：將驗證過的 JSON 編譯為自包含的 HTML/SVG 檔案。此檔案包含一個互動式檢視器，允許使用者探索地圖、追蹤路徑並播放引導式故事。
4. 迭代：代理可在維持結構穩定性的前提下，透過更新 JSON 檔案來優化圖表。

適用對象

需要使用 AI 輔助工具傳達系統設計、在合併前審查架構變更，或為新成員文件化程式碼庫的軟體架構師、開發者與技術主管。

主要特色

• 五種圖型：支援架構圖、工作流程圖、序列圖、資料流圖與生命週期圖。
• 決定性渲染：使用帶類型的 JSON IR，確保可重現且一致的佈局，而非通用的自動佈局。
• 架構差異分析：可對比兩個驗證過的快照，精確查看系統架構中新增、移除或移動的內容。
• 互動式探索：支援搜尋節點、追蹤上遊／下遊可達性、探測特定有向路徑等功能。
• 可攜式輸出：產生單一 HTML 檔案，可匯出為 PNG、SVG、WebM 或分享卡片用於文件。
• 來源錨定：在請求時，可將架構節點連結至 Git 驗證過的檔案與行範圍。