From 36d43cdf166c17f3623c3d6829d8f8c1911769b4 Mon Sep 17 00:00:00 2001 From: ila Date: Mon, 20 Jul 2026 11:10:17 +0800 Subject: [PATCH] Require pausing on requirements conflicts; ignore local run scripts Add a governance rule to AGENTS.md: when implementation reveals that requirements cannot be satisfied as written (e.g. a capability the frozen protocol cannot express), the agent must stop, record both document sources and the technical reason in the task's execution log, and request adjudication instead of silently narrowing scope or altering a frozen protocol. After adjudication, every affected document must be updated before work resumes or a new task is split off - updating only the architecture/task docs while leaving docs/02-requirements.md stale invalidates the acceptance criteria, which is the drift observed in the Phase 5 trial conflict. Also gitignore the local run-modern.bat / run-win7.bat dev scripts. Co-Authored-By: Claude Fable 5 --- .gitignore | 4 ++++ AGENTS.md | 2 ++ 2 files changed, 6 insertions(+) diff --git a/.gitignore b/.gitignore index cac147a..ce6adb0 100644 --- a/.gitignore +++ b/.gitignore @@ -33,3 +33,7 @@ __pycache__/ # 本地编辑器 workspace 配置(个人,不入库) *.code-workspace + +# 本地开发运行脚本(个人便利,不入库) +run-modern.bat +run-win7.bat diff --git a/AGENTS.md b/AGENTS.md index 7d7035d..c74e741 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -42,6 +42,8 @@ - 一次只领取一个任务(`docs/tasks/` 中 `status: TODO` 且依赖全 `DONE`、编号最靠前的),按 `docs/tasks/README.md` 约定流转状态。 - 执行记录写进该任务文件的 `## 执行记录`;项目现实变化(启动/验证路径、目录、blocker)覆盖更新 `docs/current-state.md`。 - 需求变化先改文档再改代码;不在代码里发明文档没有的接口、字段和状态。 +- **发现需求冲突必须暂停**:实现中若发现需求之间、或需求与已冻结协议/架构之间无法同时满足(例如需求要求某能力,而协议结构上无法表达),**立即停止该方向的实现**,把冲突写进当前任务文件的 `## 执行记录`(冲突双方的文档出处 + 技术原因),并向用户**请求裁定**。不得自行取舍、不得静默缩范围、不得为绕开冲突而修改已冻结协议。 +- **裁定后文档先行**:拿到裁定后,先把结论同步到**所有**受影响文档(需求、验收标准、架构、协议、路线图、任务边界),再继续实现或拆出新任务。只更新架构/任务文档而不回头修订 `docs/02-requirements.md` 会造成验收标准失效——这是已发生过的漂移(见 `docs/review/phase5-review.md` 的试用冲突)。 - 密钥、许可证私钥、真实注册码、真实下载 URL 一律不入库;示例只用占位符。 - 提交信息使用英文祈使句,任务相关提交带上 `T-<编号>`。