docs: separate design reference queue

- 将不直接执行的 process-reference 文档迁入各域 reference 目录 - 更新 design/README、AGENTS 和总序文档，固定 process/draft/reference/done 目录语义 - 修正活跃文档中指向旧 process 位置的参考链接验证：git diff --check；codegraph sync .
2026-05-21 10:19:02 +08:00
parent 1956a8a21a
commit 1569699fbb
30 changed files with 103 additions and 90 deletions
@@ -29,7 +29,7 @@
 | 文档页入口优先消费 Rust page-aggregate 快照 | DONE | `CURRENT_ARCHITECTURE.md` §2.5 |
 | 前端壳已切换到 Rust SSR（`:3000`）| DONE | `CURRENT_ARCHITECTURE.md` §3.1 |
 | Page Aggregate 写链（标题/正文/设置）smoke 通过 | DONE | `scripts/task110-*`, `task-page-aggregate-*-smoke.js` |
-| 页面设置运行时语义 / 页头回流 / AI 设置面未完全闭环 | PROCESS | `design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md` |
+| 页面设置运行时语义 / 页头回流 / AI 设置面未完全闭环 | PROCESS | `design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md` |
 | Wolai UI 行为持续对齐 | PROCESS | `design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md` |
 | `documents.content` 仍是兼容后备而非唯一真源 | PARTIAL | `CURRENT_ARCHITECTURE.md` §3.2 |

@@ -95,7 +95,7 @@
 | 垃圾箱恢复位置记录 + reveal/focus | DONE | `design/04-tree-domain/process/4-28-trash-restore-location-reveal-focus-v1.md` §2 |
 | 资源生命周期命令 `tree.resource.*`（核心 cutover 已完成，局部尾项由后续文档承接）| DONE/PARTIAL tails | `design/04-tree-domain/done/4-27-resource-lifecycle-command-cutover-v1.md`，尾项见 `4-28` / `4-34` / `4-44` / `4-45` |
 | 双浏览器 no-refresh（页面 + 文件 + 垃圾箱实时同步）| PROCESS | `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md` |
-| Local/Cloud 桥接 | P3 CANDIDATE | `design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md` |
+| Local/Cloud 桥接 | P3 CANDIDATE | `design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md` |

 ### 2.3 Simple-mindmap — ✅ 编辑器完成，AI 未覆盖

@@ -309,9 +309,9 @@
 ### 6.2 AI 资源工具

 - [x] 设计 `mnote.mindmap.*` 工具：读取结构、增删改节点、移动节点、导出 markdown summary。
-  - 设计：`design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`。
+  - 设计：`design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`。
 - [x] 设计 `mnote.office.*` 工具：读取文本摘要、写入建议、导出变更摘要；真实编辑优先复用 officecli / OnlyOffice 保存链。
-  - 设计：`design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`。
+  - 设计：`design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`。
 - [x] AI 资源工具必须走授权 root 和 resource capability。
  - 实现：Hermes manifest 已暴露 `mnote.mindmap.fetch` / `mnote.mindmap.apply_ops` / `mnote.office.fetch_summary` / `mnote.office.propose_changes`；执行侧统一校验 `rootUri` 本地授权与 `allowedResourceIds` / object identity。
  - 验证：`cargo test -p mnote-web hermes_tools_resource -- --nocapture`；`cargo test -p mnote-web hermes_tools_mindmap -- --nocapture`；`cargo test -p mnote-web hermes_tools_office -- --nocapture`；`cargo test -p mnote-web hermes_tools_manifest_returns_first_batch_tools -- --nocapture`。
@@ -338,7 +338,7 @@
 ### 7.1 导出与备份

 - [x] 设计 Web 导出入口：选择 Convex workspace，选择目标本地 root。
-  - 设计：`design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`；当前 CLI fixture 入口已支持 dry-run / apply / manifest / conflict report / rollback，Web route 与 admin 面板仍按该设计后续落码。
+  - 设计：`design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`；当前 CLI fixture 入口已支持 dry-run / apply / manifest / conflict report / rollback，Web route 与 admin 面板仍按该设计后续落码。
 - [x] 导出前创建 manifest，记录迁移计划、目标 root、workspace、操作列表、冲突、created files、backup dir 与索引刷新结果。
  - 实现：`scripts/export-convex-workspace-to-local.js --manifest <file>`；apply 成功后同时写入 `<root>/.mnote/migration-manifest.json`。
 - [x] 导出页面为 `.md`，资源写为本地文件，附件保持相对路径。
@@ -467,7 +467,7 @@
 - [x] P5 simplemindmap / office 资源模型完成 Resource Tree 产品化。
  - 证据：资源命令面、资源对象壳、AI resource tools 与 changed-files 审计已闭环；`node scripts/task456-resource-object-shell-sync-smoke.js` 已通过。
 - [x] P6 Convex 导出到本地 workspace 有 dry run、备份、冲突报告和回滚。
-  - 证据：`node scripts/task444-convex-workspace-export-local-fixture-smoke.js`；`node scripts/task455-convex-export-plan-rollback-smoke.js`；Web 入口设计见 `design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`。
+  - 证据：`node scripts/task444-convex-workspace-export-local-fixture-smoke.js`；`node scripts/task455-convex-export-plan-rollback-smoke.js`；Web 入口设计见 `design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`。
 - [x] P7 Page Aggregate / tree command / realtime 兼容链完成阶段性瘦身，并把被替代 process 稿移入 `old/` 或 `done/`。
  - 证据：Page Aggregate refresh、tree command、local folder projection refresh 与 realtime 双浏览器 smoke 均有验证；`5-5`、`5-6`、`3-3`、`4-34` 仍作为未完全 kernel-native / local-folder no-refresh 深水区过程稿保留在 `process/`，本 checklist 记录阶段性瘦身结果。
 - [x] `01-05-current-priority-overview.md` 同步更新状态，不再把已完成项描述为当前第一优先级。
@@ -6,7 +6,7 @@
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
 > - `/mnt/Data1T/mnote/CURRENT_ARCHITECTURE.md`
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
 >
@@ -7,7 +7,7 @@
 > 上位依据：
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md`
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-3-current-priority-execution-checklist-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
 >
 > 目标：给出一份可以顺序执行、每一步都有完成验收、且标明参考源码位置的下一阶段执行清单。

@@ -7,7 +7,7 @@
 > 上位依据：
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-5-next-phase-sequential-execution-checklist-v1.md`
 > - `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-4-next-phase-execution-roadmap-v1.md`
-> - `/mnt/Data1T/mnote/design/05-editor-mainline/process/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
+> - `/mnt/Data1T/mnote/design/05-editor-mainline/reference/5-14-zed-lapce-vscode-reference-adoption-matrix-v1.md`
 >
 > 目的：基于 Reasonix 执行汇总和本轮核对结果，列出仍不能标完成的缺口，形成可继续顺序执行的补充清单。

@@ -4,7 +4,7 @@
 >
 > 当前状态：`PROCESS`
 >
-> 目标：把本轮 design governance 后剩余的主线 `process/` 文档排成可执行顺序，避免后续 worker 在 40 份 process 中自行猜优先级。
+> 目标：把本轮 design governance 后剩余的主线 `process/` 文档排成可执行顺序，避免后续 worker 在 active process 中自行猜优先级。
 >
 > 上位依据：
 > - `/mnt/Data1T/mnote/ARCHITECTURE.md`
@@ -33,9 +33,9 @@
 - 或者是当前主线架构入口，仍会指导后续实现。
 - 或者有明确阻塞项、smoke 缺口、compat 瘦身缺口。

-### 2.2 Process Reference
+### 2.2 Reference

-保留在 `process/`，但不是当前直接执行 checklist。
+放在对应大类的 `reference/`，不是当前直接执行 checklist。

 典型文档：

@@ -47,6 +47,7 @@
 处理规则：

 - 不迁入 `done/`，因为不是“当前代码已完成”的实现文档。
+- 不保留在 `process/`，避免干扰后续执行队列。
 - 不当作当前 sprint 的任务源。
 - 需要转实施时，新建更小的执行 checklist。

@@ -165,7 +166,7 @@
 入口文档：

 - `design/05-editor-mainline/process/5-6-page-aggregate-alignment-checklist-v1.md`
- `design/05-editor-mainline/process/5-5-page-aggregate-single-truth-alignment-v1.md`（reference）
+- `design/05-editor-mainline/reference/5-5-page-aggregate-single-truth-alignment-v1.md`
 - `design/03-rust-web/process/3-13-rust-web-local-markdown-gfm-ast-parser-migration-v1.md`

 执行目标：
@@ -286,7 +287,7 @@

 - `design/06-mindmap/process/6-mindmap-kernel-phase6-projection-editor-v1.md`
 - `design/06-mindmap/process/6-mindmap-phase6-leptos-ui-shell-reuse-checklist-v1.md`
- `design/06-mindmap/process/6-mindmap-leptos-adapter-reference-notes-v1.md`（reference）
+- `design/06-mindmap/reference/6-mindmap-leptos-adapter-reference-notes-v1.md`

 执行目标：

@@ -304,8 +305,8 @@
 入口文档：

 - `design/05-editor-mainline/process/5-9-wolai-aline-continuous-checklist-v1.md`
- `design/08-wolai-aline-test-flow/process/wolai-aline-test-flow-v1.md`（workflow reference）
- `design/05-editor-mainline/process/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`（reference）
+- `design/08-wolai-aline-test-flow/reference/wolai-aline-test-flow-v1.md`
+- `design/05-editor-mainline/reference/5-7-wolai-page-tree-main-editor-experience-restoration-v1.md`

 执行目标：

@@ -321,17 +322,17 @@

 这些文档不进入当前直接执行序列，只有当产品优先级明确时再拆 checklist：

- `design/03-rust-web/process/3-17-convex-export-web-entry-v1.md`
+- `design/03-rust-web/reference/3-17-convex-export-web-entry-v1.md`
  - CLI 已有迁移闭环；Web 管理入口未排期。
- `design/04-tree-domain/process/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md`
+- `design/04-tree-domain/reference/4-23-local-cloud-explicit-bridge-p3-candidate-v1.md`
  - P3 候选，不能进入 local-first 默认主链。
- `design/07-ai/process/7-17-acp-session-convex-sharing-contract-v1.md`
+- `design/07-ai/reference/7-17-acp-session-convex-sharing-contract-v1.md`
  - Future sharing contract。
- `design/07-ai/process/7-28-resource-ai-tool-contract-v1.md`
+- `design/07-ai/reference/7-28-resource-ai-tool-contract-v1.md`
  - mindmap / office Resource AI tool 草案。
- `design/09-siyuan-reference/process/9-siyuan-reference-boundary-and-adoption-v1.md`
+- `design/09-siyuan-reference/reference/9-siyuan-reference-boundary-and-adoption-v1.md`
  - 参考边界，不是实施入口。
- `design/10-review/process/12-*`、`13-*`、`14-*`
+- `design/10-review/reference/12-*`、`13-*`、`14-*`
  - 原始 review 证据；执行项已拆出或归档。

 ## 9. 推荐执行批次
@@ -407,7 +408,7 @@
 ## 11. 不做事项

 - 不按文件编号顺序清空 process。
- 不把 `process-reference` 当作当前实现任务。
+- 不把 `reference/` 下的资料当作当前实现任务。
 - 不因为文档老就移动到 `done/`；必须有真实完成证据。
 - 不把 Phase C / Review Mode / cloud sync / sharing future 合同提前实现。
 - 不恢复旧 Next / BlockNote / Convex 默认主存储口径。