Hainrixz/the-architect

解決的問題

Architect 是 Claude Code 的元代理，解決了「幻覺」或不完整軟體計畫的問題。它在撰寫任何應用程式程式碼之前，先建立嚴謹且詳細的藍圖，防止自主 AI 建構者做出錯誤假設或過度建構。

如何運作

此工具透過四階段設計流程運作：

1. 發現：將專案分類為 14 種「形狀」之一（例如 SaaS、Agent App、CLI），並判斷是新程式碼還是既有程式碼。
2. 深度探查：使用 stack-researcher 子代理，透過與即時註冊表比對來驗證函式庫版本，確保技術堆疊為最新狀態。
3. 架構設計：定義技術堆疊與範圍，通過兩個強制性關卡：關卡 A（解決所有未明確標記的項目）與 關卡 B（對抗性預死前分析，識別潛在風險）。
4. 生成：blueprint-writer 與 blueprint-validator 產生並審核一份包含 20 個固定區段的 Markdown 藍圖，其中包含嚴格的建構順序與明確的「完成條件」與「驗證」標準。

適用對象

專為使用 Claude Code 的開發者設計，他們希望以最少的手動干預將專案交給自主建構代理，也適用於管理「棕地」專案（即必須整合至既有程式碼庫中的變更）的人員。

主要亮點

• 防漂移建構步驟：每個步驟都包含明確的 Do、Done when、Verify 與 Checkpoint 欄位，防止代理漂移。
• EARS 接受標準：採用「需求語法的簡易方法」（WHEN <觸發條件> THE SYSTEM SHALL <回應>），確保所有標準皆可由腳本判定。
• 與技術堆疊無關的專案形狀：14 種預定義專案形狀，將「做什麼」（形狀）與「怎麼做」（執行時軌跡）及「能力」分離。
• 棕地支援：包含專用流程用於映射既有倉儲，尊重既有慣例與代理指示。
• 即時註冊表驗證：在設計階段透過與權威註冊表比對，防止依賴項過時。