diff --git a/docs/milestone-propose-requirements.md b/docs/milestone-propose-requirements.md
index 54796c1..5f0b749 100644
--- a/docs/milestone-propose-requirements.md
+++ b/docs/milestone-propose-requirements.md
@@ -823,6 +823,52 @@
 - 或 P12.2-P12.3 文档编写（状态机总览 + 权限总览 + propose 流程说明）
 - 或 P13.1 开始编写 milestone 后端测试
 
+### 2026-03-18 02:00 UTC（第 26 轮：P12.2-P12.3 文档编写 — 状态机总览 + 权限总览 + Propose 流程）
+
+本轮做了什么：
+- 编写三份核心文档，完成 P12.2-P12.3
+- **`docs/state-machine-overview.md`**（状态机总览）：
+  - Milestone 状态枚举、流转图、流转条件、编辑限制矩阵
+  - Task 状态枚举、流转图、流转条件、编辑限制、与 milestone 联动约束
+  - Propose 状态枚举、流转图、流转条件、accept 副作用、编辑限制
+  - 创建限制说明（story/feature 和 maintenance/release 的正确入口）
+  - 旧枚举 → 新枚举映射表（DB 迁移参考）
+- **`docs/permissions-overview.md`**（权限总览）：
+  - 9 个新增权限一览（名称、category、含义）
+  - 4 个默认角色的权限分配矩阵（admin/mgr/dev/guest）
+  - 权限设计原则（独立不合并、增量同步、操作者校验）
+  - 前端可见性现状说明
+  - 自定义角色指引
+- **`docs/propose-flow.md`**（Propose 流程）：
+  - 完整流程图（创建 → 审阅 → accept/reject → reopen）
+  - 各步骤详细说明（前置条件、系统执行、后续效果）
+  - Feature task 生命周期与约束
+  - Milestone 完整生命周期（含 propose 环节）
+  - Propose 编码规则
+  - API 端点与 CLI 命令速查
+
+改了哪些关键文件：
+- `HarborForge/docs/state-machine-overview.md` — 新增
+- `HarborForge/docs/permissions-overview.md` — 新增
+- `HarborForge/docs/propose-flow.md` — 新增
+
+验证结果：
+- 已 commit：`90e1b4d`
+- 文档内容与已实现代码逻辑交叉校验一致
+
+当前阻塞/风险：
+- P13 自动化测试未开始（milestone/task/propose 后端测试）
+- P14 收尾验收未开始（手工走流程 + 数据迁移验证）
+- 前端按钮权限可见性仍未根据用户权限做细粒度控制
+- 无本地 MySQL/运行环境做集成验证
+
+下一轮最建议继续做什么：
+- P13.1 开始编写 milestone 后端测试骨架（freeze/start/close/auto-complete 的核心路径）
+- 或 P13.3 propose 后端测试（accept/reject/reopen + feat_task_id 生成）
+- 或 P13.2 task 后端测试（状态流转合法性 + assignee 校验 + comment 强制）
+
+---
+
 ### 2026-03-18 01:00 UTC（第 25 轮：Batch Transition 全量校验同步 P5.2-P5.6）
 
 本轮做了什么：