diff --git a/xiaoqu-agent-service/AGENTS.md b/xiaoqu-agent-service/AGENTS.md
index 0cf946e..82de46f 100644
--- a/xiaoqu-agent-service/AGENTS.md
+++ b/xiaoqu-agent-service/AGENTS.md
@@ -27,5 +27,6 @@
 ## 生产部署要点
 
 - `./deploy/deploy.sh remote-deploy`（SSH 别名 xiaoqu-prd，目录 /data/xiaoqu-agent-service）。
+- **部署前必须先把 main 推 origin**：出现过本地 main 领先 origin 1 个修复提交、他人从 origin 构建部署导致生产跑到旧代码的情况（2026-09-22 paperuselog terms 结构 400）。
 - 新工具上线后必须幂等绑 prod scope（svc 库 MySQL，tool 表唯一标识列是 `name`；scope 表是 `agent_scope`）：hardware/district 系列惯例绑 scope 1(test)/2(operation)/3(xiaoqu-ai)/5(ops-query)，工单/仓库系列只绑 scope 1。
 - prod AK 的 Authorization 头值本身已含 "Bearer " 前缀，不要再拼。