Theme / v3.0.1

Archify

把想法變成可互動的圖

實戰範例

實戰範例 002:Repo 實證架構圖

以 mco-org/mco@9f1a1cf 為例:讀 repo、釘 commit、SRC 節點的可信畫法

背景

為陌生 repo 畫「可信」的架構圖:每個關鍵節點都能點開看到 Git 驗證過的檔案與行號,且全部釘在同一個公開 commit。官方以 mco-org/mco@9f1a1cf 示範。1

完整流程

步驟 1:在 repo 根目錄提問

Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.
Put supporting detail in cards instead of adding more edges.

步驟 2:確認證據規則

  • 證據節點標 SRC n,開 Git 驗證檔案與行號,釘單一公開 commit
  • 一般節點保持無來源,不要硬掛證據
  • 細節放卡片,不要加更多邊

步驟 3:交付

node bin/archify.mjs finalize architecture candidate.json output.html --repo-root <repo-root> --quality showcase --json

對應官方產物

Footnotes

  1. tt-a1i/archify README Understand a real repository ↩