diff --git a/.agents/PROJECT.md b/.agents/PROJECT.md
index 8deeaf0..dc56f05 100644
--- a/.agents/PROJECT.md
+++ b/.agents/PROJECT.md
@@ -22,3 +22,4 @@
 |---------|--------|------|
 | [project-dev-runtime-deploy.md](./rules/project-dev-runtime-deploy.md) | 全局 | 本项目开发/运行/部署的实际模式（必备） |
 | [project-business-constraints.md](./rules/project-business-constraints.md) | 全局 | 不可协商的业务硬约束（可选，有则记） |
+| [project-update-strategy.md](./rules/project-update-strategy.md) | 框架更新 | admin:update 执行策略（默认对比更新无需创建，切换到按需手动更新时启用） |
diff --git a/.agents/rules/project-update-strategy.md b/.agents/rules/project-update-strategy.md
new file mode 100644
index 0000000..2d73dbf
--- /dev/null
+++ b/.agents/rules/project-update-strategy.md
@@ -0,0 +1,42 @@
+# 框架更新策略
+
+> 来源：使用者业务（project-）
+> 作用域：框架更新流程（admin:update 命令的执行策略）
+> 触发条件：智能体执行或协助 admin:update 前
+
+<!-- 模板说明：
+- 本文件是"按需手动更新"策略的记录模板，默认不需要创建。
+- 默认策略 = 对比更新（标准 admin:update），无需此文件。
+- 仅当项目长期采用"按需手动更新"策略时，才创建本文件。
+- 创建后尽量不频繁修改，仅在策略本身发生变化时更新。
+-->
+
+本项目框架更新（`php think admin:update`）的执行策略记录。用于在标准对比更新不适用时，明确本项目的更新方式。
+
+更新命令的通用操作流程见 [ulthon-update-workflow](../skills/ulthon-update-workflow/SKILL.md)。
+
+## 当前策略
+
+`对比更新`
+
+（可选值：
+
+- `对比更新`：标准 `admin:update`。**默认策略，无需创建本文件。**
+- `按需手动更新`：使用 `--fetch-only` 拉取上游代码到本地，由 AI 或开发者选择性合并。适用于定制极多、不信任自动冲突策略的项目。
+
+## 采用原因
+
+（切换到"按需手动更新"时填写。例如：app/ 定制量大、历史上强制覆盖丢失过定制等。未切换则留空。）
+
+## 注意事项
+
+（记录策略层面的长期约束，例如：
+
+- 已深度定制、上游变更需特别谨慎的文件或目录
+- 合并偏好（如 extend/base/ 一律接受覆盖，定制通过 app/ 扩展层实现）
+
+未切换策略时留空即可。）
+
+## 相关技能
+
+- [ulthon-update-workflow](../skills/ulthon-update-workflow/SKILL.md)