改進程式碼庫架構 Improve Codebase Architecture

它做什麼

尋找架構上的摩擦，提出「加深」的機會，目標是可測試性與便於 AI 瀏覽程式碼。它先依 git 歷史裡的熱點縮小範圍，讀取 GLOSSARY.md 與相關 ADR，再派生一個子智能體去走查程式碼，找出淺模組、洩漏的接縫與難以測試的部分，並用「刪除測試」來判斷。它把一份自成一體的 HTML 報告（Tailwind 與 Mermaid 來自 CDN）寫到系統暫存資料夾並開啟：每個候選方案都有涉及的檔案、問題、方案、效益、客製的前後對比圖與強度徽章，最後給出首要推薦。它使用固定的詞彙（module、interface、depth、seam、adapter、leverage、locality）。你選定一個之後，它會沿著決策樹追問，並同步更新 GLOSSARY.md 與 ADR。

輸出

一份 HTML 架構審查，以及圍繞你所選方案的互動式設計討論。

適合什麼場景

想對程式碼哪裡「淺」做一次結構化、視覺化審查，並願意採用一套共同設計詞彙的團隊。