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）服务器，为代理提供关于仓库地图和发现结果的上下文。
• 基于证据：报告违反规范的确切文件和行号。
• 治理导向：任何对仓库契约或治理决策的更改都需要明确的人类确认。