📝 docs(main_loop): enforce plan archive completion gate

This commit is contained in:
csh
2026-05-28 08:57:01 +08:00
parent 0093fbf341
commit e87be183bc
4 changed files with 45 additions and 2 deletions
@@ -24,6 +24,8 @@
- 局部修改优先局部验证
- 不能运行的验证必须写明原因
- 不手工改写 `workflow-state``plan-status` 状态块
- 如本轮来自 `main_loop.py claim`,验证通过不等于 Plan 完成;Plan
`done` 还必须完成当前 Plan 变更归档/提交
## 验证步骤
@@ -33,7 +35,10 @@
4. 复核 diff 是否只包含预期修改
5. 如本轮来自 `main_loop.py claim`,复核 `workflow-state.phase`
`plan-status` 与当前声明一致
6. 汇总未覆盖项和剩余风险
6. 如本轮来自 `main_loop.py claim` 且结果为 `done`,复核当前 Plan
相关差异是否已经归档/提交;未归档时只能声明“验证完成”,
不能声明“Plan 完成”
7. 汇总未覆盖项和剩余风险
## 输出协议
@@ -56,6 +61,8 @@
- 如本轮来自 `main_loop.py claim``workflow-state.phase` 是否与当前声明一致
- 如本轮来自 `main_loop.py claim``plan-status` 是否已经通过
`main_loop.py finish` 写回
- 如本轮来自 `main_loop.py claim` 且结果为 `done`,当前 Plan 相关差异
是否已经归档/提交,或是否已说明无当前 Plan 差异
- 如为代码类任务,`workflow-state` 中是否保留:
`executor=executing-plans`
`constraints=karpathy-guidelines,.agents,AGENT_RULES`
@@ -63,6 +70,7 @@
## 停止条件
- 关键验证失败时停止并汇报
- 当前 Plan 相关差异未归档/提交时,不得声明 Plan 完成
- 证据不足以支持“完成”结论时停止并汇报
---