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-<编号>`。