何時使用
✅ 適合:元件/服務/儲存/邊界、雲與安全拓撲、基礎設施、repo 實證系統地圖。 ❌ 不適合:單一互動隨時間經過(用 Sequence)、管線血緣(用 Data Flow)、狀態機(用 Lifecycle)。
Prompt 要給什麼
範圍(scope)、核心元件(8–12 個為常用起點)、主要路徑(primary path)。細節放卡片,不要加更多邊。
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.
Schema 與範例
- Schema:
schemas/architecture.schema.json - 範例:
examples/web-app.architecture.json(系統/服務/函式庫/CLI)、examples/production-deployment.architecture.json(部署)
邊界種類先查 schema
選新欄位、enum 或受限文字前先讀 schema 定義,特別是 boundary kinds。範例教形狀不教事實。
deployment-ownership(可選 profile)
缺少已撰寫 owner、region 放置、私有資料庫範圍或具名跨越時直接失敗;絕不隱含推斷,不檢查即時基礎設施。