diff --git a/CLAUDE.md b/CLAUDE.md
index 029e711..12dcebc 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -16,6 +16,14 @@
 - Agent 身份通过各自环境变量设置（Dev: `pzhang_dev_agent_01`，QE: `pzhang_qe_agent_01`）
 - **所有 Gitea API 操作必须通过 `python scripts/agent_poller.py`**，禁止直接 curl 或硬编码 token
 
+## 代码同步
+
+Dev-Agent 和 QE-Agent 持续向 main 提交代码，本地可能落后。Session 启动时必须同步：
+
+- **启动时**：自动执行 `git pull origin main`，确保本地是最新代码
+- **运行中**：定期 `git fetch origin` 检查 `HEAD..origin/main`，有新提交则 pull
+- **有冲突时**：暂停并报告，不自动解决（人工介入）
+
 ## 上下文管理
 
 Context window 有限。当 session 持续较长时间时：
@@ -32,6 +40,7 @@ Context window 有限。当 session 持续较长时间时：
    - `test-code` → QE-Agent 域，`product-code` → Dev-Agent 域
    - 即使内容看似不在自身常规范围，只要 label 指定了自己的域，就必须 pick up
    - Label 与内容明显冲突时，先 pick up 并评论确认，不直接跳过
+4. **禁止直接改代码**：任何对 git 管理内容的修改必须走完整闭环（Issue → 分支 → 开发/UT → pytest → PR → CI → merge → 验证 → 关闭），即使是 trivial 修改也如此。禁止绕过此流程直接编辑文件
 
 ## Agent 模式