dadbodgeoff/drift

解決的問題

Drift 可防止 AI 代理引入違反現有倉儲規範的程式碼。它特別針對代理撰寫程式碼時忽略既定架構模式的問題，例如在 Next.js 專案中禁止 API 路由直接匯入資料存取用戶端。

工作原理

Drift 使用基於 Rust 的掃描引擎和 TypeScript CLI 來分析程式碼並強制執行宣告的分層契約。它完全在本機執行，將狀態和倉儲智慧儲存在 SQLite 資料庫中。它透過分析程式碼庫來識別規範，並允許人類接受或拒絕這些候選規範。一旦某個規範成為倉儲契約的一部分，Drift 就可以檢查變更差異，查看新變更（通常由 AI 代理產生）是否違反這些規則，如果設定為阻斷模式，則會以錯誤碼退出，阻止該變更。

適用對象

使用 TypeScript 或 JavaScript 與 Next.js（App Router 或 Pages）的開發者，使用 AI 代理產生程式碼，並希望在無需手動審查每一行程式碼是否違反規範的情況下維護架構完整性。

主要亮點

• 本機優先執行：完全在使用者機器上執行，無需雲端同步或外部伺服器需求。
• 決定性強制：使用宣告的契約來阻止違規，而非依賴通用的 LLM 基於程式碼審查。
• 代理就緒：包含一個唯讀的 MCP（Model Context Protocol）伺服器，為代理提供關於倉儲地圖和發現結果的上下文。
• 基於證據：報告違反規範的確切檔案和行號。
• 治理導向：任何對倉儲契約或治理決策的變更都需要明確的人類確認。