AgileBuilder 与 AGENTS.md / .cursor/rules 约定文件的区别

约定文件解决什么问题

AGENTS.md、.cursor/rules 这类约定文件是写给 AI 的静态说明文本，常见的用途包括：

• 告诉 AI 项目的编码风格与命名习惯
• 声明技术栈、目录约定和提交规范
• 约束 AI 在修改代码时的行为边界

它们轻量、易写、随仓库走，是给 AI 提供上下文的好方法。

约定文件的边界

约定文件本质上是"被动说明"：

• 它描述规则，但不执行规则，项目结构仍然要靠人或其他工具搭出来
• 它依附于已有仓库，新项目启动的那一刻还没有它
• 在多个仓库之间保持一致，需要逐个复制、逐个维护

AgileBuilder 解决的是另一层问题

AgileBuilder 管的是"项目骨架与初始化流程"：

• 模板是可执行的：EJS 变量渲染、目录与文件骨架、生成后 hooks 都在模板里定义
• 模板可以版本化分发：团队统一维护一处模板，各项目从同一基线生成
• 结合云端空间与权限，团队可以控制谁能使用和更新哪些模板
• 通过内置 MCP server，AI IDE 可以直接调用模板创建项目

两者是互补关系

这不是二选一。一种常见的组合方式是：

1. 用 AgileBuilder 从团队模板生成项目骨架，完成初始化
2. 模板中同时包含一份 AGENTS.md 或 .cursor/rules，作为生成结果的一部分
3. AI 在后续编码中读取约定文件，继续遵守团队规范

约定文件让 AI "写得对"，AgileBuilder 让项目 "起步对"。把约定文件放进模板里，两层规范可以一起落地。