diff --git a/docs/design/13-toolchain-and-dev-workflow.md b/docs/design/13-toolchain-and-dev-workflow.md
index 5723bec..e64b2d0 100644
--- a/docs/design/13-toolchain-and-dev-workflow.md
+++ b/docs/design/13-toolchain-and-dev-workflow.md
@@ -2741,3 +2741,15 @@ Gitea v1.23.4 自带完整的 CI 管理界面：
 | — | 评审 | testing-workflow 加广播风暴禁止 | §17.4.2 testing-workflow 补充约束 |
 | — | 评审 | ci-cd-ops 行数估算措辞 | 修正：重写后预计 ~120 行（原 114 行） |
 | — | 评审 | 覆盖率 P1 前提需确认 | §17.7.1 明确指出 deploy.yml 已有 coverage，ci.yml 有意不加 |
+
+---
+
+### v3.0 → v3.1 变更（P3 端到端验证 + 调研结论）
+
+| 编号 | 变更内容 |
+|------|----------|
+| §17.3.3 | Review API event 枚举值修正：APPROVE → APPROVED |
+| §17.6.3 | 注意更新：runs-on 已改为 macos-arm64，placeholder 已替换 |
+| §17.6.4 | 新增 P3 端到端验证结果（S1-S6 逐项） |
+| §17.6.4 | 新增调研发现：Review API 枚举值、PullRequestReview webhook 支持、act-runner PM2 托管 |
+| §17.10 | #1 状态更新：act-runner 已纳入 PM2 托管 |