docs: separate design reference queue
- 将不直接执行的 process-reference 文档迁入各域 reference 目录 - 更新 design/README、AGENTS 和总序文档,固定 process/draft/reference/done 目录语义 - 修正活跃文档中指向旧 process 位置的参考链接 验证:git diff --check;codegraph sync .
This commit is contained in:
+16
-6
@@ -11,8 +11,9 @@
|
||||
>
|
||||
> 状态口径以当前仓库真实代码为准:
|
||||
> - `[done]`:对应阶段或收口目标已经在当前主线代码中成立
|
||||
> - `[process]`:方向已进入主线,但仍在推进中
|
||||
> - `[process-reference]`:仍在 `process/` 下保留,但只作为参考流程、候选合同、对照证据或长期设计边界;不代表当前可直接执行的 checklist
|
||||
> - `[process]`:方向已进入主线,且当前可以直接拆 checklist / owner / 验收继续执行
|
||||
> - `[draft]`:方向尚未成形,不能直接派发实现
|
||||
> - `[reference]`:参考流程、候选合同、对照证据、review 原始材料或长期设计边界;不代表当前可直接执行的 checklist
|
||||
> - `[recycle]`:已废弃、已被后续稿件替代,统一归档到 `old/`
|
||||
|
||||
## 当前优先级入口
|
||||
@@ -27,44 +28,53 @@
|
||||
1. `01-tree-first-graph-kernel/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
2. `02-convex-rust-long-term-architecture/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
3. `03-rust-web/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
4. `04-tree-domain/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
5. `05-editor-mainline/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
- `reference-code/` 放编辑器参考代码
|
||||
6. `06-mindmap/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
7. `07-ai/`
|
||||
- `process/` 放推进中的主线稿
|
||||
- `done/` 放已在真实代码中成立的主线稿
|
||||
- `reference/` 放参考材料;`draft/` 放未成形草稿
|
||||
8. `08-wolai-aline-test-flow/`
|
||||
- `process/` 放推进中的测试流程与对标执行稿
|
||||
- `reference/` 放 Wolai 对标流程基线;具体执行任务应拆到对应主线 `process/`
|
||||
9. `09-siyuan-reference/`
|
||||
- `process/` 放思源参考、借鉴边界与能力盘点稿
|
||||
- `reference/` 放思源参考、借鉴边界与能力盘点稿
|
||||
10. `10-review/`
|
||||
- `done/` 放阶段性代码 / 架构审查证据和结论
|
||||
- `reference/` 放对照审查原始证据、参考矩阵和后续候选项
|
||||
- 只作为当前实现状态证据和历史审查归档,不作为新的主线优先级入口
|
||||
|
||||
## 迁移规则
|
||||
|
||||
- 主线设计稿完成后,必须从对应大类的 `process/` 移动到 `done/`。
|
||||
- 仅以当前真实代码为准判断是否完成,不能只按稿件自述判断。
|
||||
- 对于未完成但当前不排期的候选设计、参考矩阵、对标流程和 review 原始证据,不移动到 `done/`,必须在文件头部标记 `process-reference` 并说明当前不作为 active implementation checklist。
|
||||
- 对于未完成但当前不排期的候选设计、参考矩阵、对标流程和 review 原始证据,不移动到 `done/`,必须移动到对应大类的 `reference/` 并在文件头部标记 `[reference]`。
|
||||
- 只有能直接执行的 checklist 才允许留在 `process/`;如果只是想法但还没形成 owner / 验收 / 归档条件,先放 `draft/`。
|
||||
- 废弃稿统一移动到 `old/` 对应大类下,再按历史成熟度放入 `process/` 或 `done/`。
|
||||
|
||||
## 辅助目录
|
||||
|
||||
- `90-reference/`
|
||||
- 参考资料,不参与 `[done]/[process]/[recycle]` 状态判断
|
||||
- 跨域生态参考资料,不参与 `[done]/[process]/[draft]/[reference]/[recycle]` 状态判断
|
||||
- 引用时只能作为生态资料或背景材料,不能覆盖 `ARCHITECTURE.md`、`AGENTS.md`、`01-05` 当前优先级或对应主线 `process/` / `done/` 设计稿
|
||||
- `old/`
|
||||
- 已废弃或被替代的历史稿件,标题统一标记 `[recycle]`
|
||||
|
||||
Reference in New Issue
Block a user