深度规划
将不确定的工程工作转化为一个新代理可执行的计划，且不会静默地扩大范围。先进行调查，按风险排序，并保留一个由协调员拥有的进度记录。
操作契约
- 在规划时不实现产品代码。
- 源文件保持不变。规划只能写入下面指定的命名空间工件。
- 首先阅读仓库说明、架构、测试、模式、CI 和邻近的约定。
- 保留脏工作。绝不暂存、重置、清理、暂存或吸收不相关的更改。
- 区分仓库事实、用户决策、假设、推论和未解决的问题。
- 不凭空制造阶段或清理工作。
执行模式
根据后果和不确定性选择，而非仅基于代码行数。
- 快速： 一个具有明显契约的低风险关注点。返回一个提示和内联验证。
- 标准： 几个耦合的文件或一个实质性边界。创建二到四个阶段。
- 深度： 身份验证、资金、迁移、破坏性操作、并发、公共契约、基础设施或交互系统。添加明确的决策、特性描述、独立验证和回滚门。
升级一个小的、高风险的变化。不要夸大一个大的、机械性的变化。
调查与框架
确定仓库根目录、修订版本、分支、脏状态、适用的说明、预期的可观察结果、验收来源、入口点、受影响的组件和契约、现有部分解决方案、项目原生的检查以及实质性歧义。自行发现仓库事实。仅向用户询问可能实质性改变计划的决策。
构建按风险排序的计划
按适用情况排序工作：
- 建立基线和重现当前行为；
- 确定产品、兼容性、数据、安全和操作决策；
- 在变化的边界周围添加特性描述或契约测试；
- 实现最小的、连贯的根因切片；
- 验证聚焦的行为和邻近的回归；
- 独立质疑具有重大风险的工作；
- 更新文档、迁移、上线和回滚相关的内容；
- 最后执行可选的清理。
每个阶段陈述其目标、排序理由、前置条件、依赖项、允许和禁止的路径、自包含的提示、精确的检查和预期结果、恢复、用户决策以及停止条件。
提示契约
每个实现提示包括一个可观察的关注点、精确的路径权限、需求、修订版本、要模仿的示例、[read-only] 或 [writes code]、边缘和失败行为、聚焦和更广泛的检查、要捕获的证据、回滚、删除前的零调用者证明，以及当前提或权限失败时停止的规则。根据独立的可审查性、可验证性和可逆性来拆分，而不是通用的代码行数限制。
命名空间工件
标准和深度计划创建：
.agents/runs/deep-plan/<run-id>/
├── PLAN.md
├── progress.jsonl
├── evidence.json
└── prompts/
使用冲突避免的 UTC 运行 ID。绝不要覆盖以前的运行或根级别的 PLAN.md。只有协调员更新 PLAN.md 并追加规范的 progress.jsonl 事件。并行工作器返回结构化事件或写入代理特定的文件；它们绝不同时追加到一个共享文件。
一个进度事件记录了时间戳、阶段、状态、有边界的摘要、精确的检查、矛盾以及下一个安全操作。
关闭
以推荐的第一阶段、可信的失败模式、最弱的证据、排除的邻近工作、用户拥有的决策、完成和终止标准以及确切的工件路径结束。该计划不授权实施、发布、部署、破坏性操作或外部消息。