diff --git a/src-tauri/resources/onboarding/AGENTS.md.tmpl b/src-tauri/resources/onboarding/AGENTS.md.tmpl
index 54d6373..1b29911 100644
--- a/src-tauri/resources/onboarding/AGENTS.md.tmpl
+++ b/src-tauri/resources/onboarding/AGENTS.md.tmpl
@@ -18,7 +18,7 @@
 
 <!-- TODO: 列出 README / ARCHITECTURE.md / 其他关键文档及用途。 -->
 
-<!-- ONBOARDING_MANAGED_START version="1.4.0" -->
+<!-- ONBOARDING_MANAGED_START version="1.5.0" -->
 ## 核心开发约束
 
 ### 包管理
@@ -35,6 +35,28 @@
   另建 `test:install` 脚本显式安装浏览器（`playwright install --with-deps`），
   升级时有意识操作，避免 pnpm install 静默触发 ~200MB 的浏览器重下
 
+## 需求对齐协议
+
+开始写代码前，先判断改动类型：
+
+**Bug Fix**（当前行为与预期的意外偏差）
+→ 建任务卡，直接执行，无需等确认词。
+
+**Feature / 行为变更**（新增能力或主动改变已有行为）
+→ 必须先输出确认卡，等用户说「确认」再动手：
+
+- **S 级**（单文件、行为对外无变化，任务卡 complexity=S）：输出三行轻量卡
+  ```
+  改哪：<文件或模块>
+  改什么：<一句话>
+  验收：<agent_verify 路径>
+  ```
+- **M / L 级**：输出完整任务卡（含 `files` + `acceptance` + `complexity`），等确认
+
+**边界模糊时**：保守判断，按 Feature 处理，走完整确认卡。
+
+> ⚠️ Session 结束汇总补录 ≠ 确认卡替代——补录仅适用于漂移检测触发后用户主动选择补录的场景，不得作为「先做再补」的通道。
+
 ## Git 工作流
 
 见 `docs/ai-context/git-workflow.md`（分支策略 + Conventional Commits + Rules-Applied trailer + PR 规范）。