我在用 Codex 和 GPT-5.6-Sol 完成第一個較大型的專案後，發現了一個問題：AI 可以很快地寫出能編譯、能通過測試的程式，但專案的架構可能在不知不覺中變得更混亂。

而且不只是 AI，我自己在快速開發時，也很難持續掌握模組之間的依賴、責任邊界，以及某次修改是否引入新的循環依賴。這就是 Braid 的起點。

Braid 是什麼

Braid 是一個面向 TypeScript 專案的本地架構分析與防護工具。

它可以：

  • 分析模組與檔案之間的依賴
  • 偵測循環依賴與部分結構問題
  • 產生可審查的重構建議
  • 在 coding-agent session 中建立基準
  • 阻止新出現的架構退化
  • 在隔離的 Git 環境中執行經批准的 migration

最核心的流程是：

健康基準
→ AI 修改程式
→ Braid 偵測架構退化
→ 阻止完成
→ AI 修復
→ 再次檢查並通過

開發過程

Braid 使用 TypeScript monorepo 建立，並將 analyzer、planner、migration、recovery、state 與 agent integration 分成不同元件。

Codex 主要負責 repository-level 的實作、測試、錯誤重現與 release 驗證；GPT-5.6-Sol 則協助我處理產品方向、架構設計、任務拆解，以及審查 Codex 的結果。

開發過程中最困難的部分，是讓不同 coding agents 共用同一套可靠的架構判斷，同時確保 Braid 不會擅自修改、合併或推送使用者的程式碼。

我們也在真實的四個 workspace 專案 Flota 上測試 Braid。Braid 找出了一個 driver boundary 周圍的依賴循環；重構後保留了既有 public API，190 個測試與 TypeScript typecheck 也全部通過。

目前成果

Braid 現在支援 Codex、Gemini CLI 與本地 GitHub Copilot CLI，並提供可重現的安裝、Demo、CI 與自動化測試。

它的目的不是取代工程師做架構決策，而是讓 AI 產生的結構變化變得清楚、可驗證、可審查。

當 coding agents 越來越快，真正重要的問題不只是「程式能不能跑」，而是：

這次修改，是否讓整個系統變得更健康？

Braid 就是為了回答這個問題而建立的。