约束即速度

约束即速度

约束即速度（Constraints as Speed）是Agent-First开发模式中的一项核心架构设计原则。它挑战了"自由即高效"的传统认知，主张通过严格的架构约束和自动化检查，为AI Agent提供清晰的边界和规则，反而能提升其开发速度。

核心思想

明确的边界：为Agent提供清晰的架构边界和规则，减少决策空间。
自动化执行：通过自定义lint等工具自动拦截违规行为。
错误指引：错误消息嵌入修复指引，让Agent能自行纠正。
集中管控，局部自治：在关键边界集中管控，在局部区域给予Agent自由度。

实践方法

固定层次：每个业务领域分为固定层次（Types → Config → Repo → Service → Runtime → UI）。
单向依赖：依赖方向严格单向，避免循环依赖。
接口注入：跨切关注点通过Providers接口注入。
自定义lint：拦截架构违规，嵌入修复指引。
Agent可读性优先：代码正确、可维护、对未来Agent可读即合格。

解决的问题

Agent决策混乱：缺乏约束时Agent可能产生不一致的架构决策。
代码质量下降：Agent会复制仓库中的不良模式。
维护成本上升：缺乏统一架构导致系统难以维护。

与相关概念的关系

[[agent可读性]]：约束即速度是确保Agent可读性的重要手段。
[[harness-engineering]]：该原则是Harness Engineering架构设计的核心。
[[ai-code-generation]]：该原则指导AI代码生成的质量控制。