44 lines
2.5 KiB
Markdown
44 lines
2.5 KiB
Markdown
# 文档导航
|
||
|
||
本目录按“产品契约、当前任务、实现事实、长期规划、验收证据”分层。领取任务时不要从仓库根目录
|
||
开始通读；只读取当前队列、当前任务卡和机器 manifest 指向的状态页。
|
||
|
||
## 领取任务
|
||
|
||
1. [EXECUTION_QUEUE.md](EXECUTION_QUEUE.md)：唯一的短周期入口，给出当前 `nextTask` 和读取顺序。
|
||
2. `tasks/<task>.md`：当前任务的最小上下文、范围和验收命令。
|
||
3. `tests/golden/<task>/manifest.json`：机器事实源，确认 parent、输入构件和下一个任务。
|
||
4. `status/<task>.md`：完成后写入证据、hash、状态和回滚方式。
|
||
|
||
需要拆分实施或控制上下文时，先看 [TASK_BREAKDOWN.md](TASK_BREAKDOWN.md)。它提供阶段地图、
|
||
原子任务门、当前 M14-04F 的子任务和后续任务草案，但不覆盖 manifest/status 的机器事实。
|
||
|
||
任务卡使用 [TASK_CONTEXT_TEMPLATE.md](TASK_CONTEXT_TEMPLATE.md) 的固定结构；卡片只描述一个主要
|
||
行为或一个证据变化，不复制实现日志。
|
||
|
||
## 事实源
|
||
|
||
| 问题 | 文件 |
|
||
| --- | --- |
|
||
| V1 承诺、非目标、发布门 | [WEB_BLENDER_MODELER_V1_SCOPE.md](WEB_BLENDER_MODELER_V1_SCOPE.md) |
|
||
| 当前领取顺序 | [EXECUTION_QUEUE.md](EXECUTION_QUEUE.md) + 当前 manifest 的 `nextTask` |
|
||
| 当前实现和风险 | [PROJECT_STATUS_AND_NEXT_WORK.md](PROJECT_STATUS_AND_NEXT_WORK.md) |
|
||
| M12-M23 长期原子计划 | [BLENDER_5_2_FULL_WEB_PARITY_EXECUTION_PLAN.md](BLENDER_5_2_FULL_WEB_PARITY_EXECUTION_PLAN.md) |
|
||
| 机器状态和发布证据 | `status/parity-ledger.json`、`status/release-evidence.json` |
|
||
| Blender 全域覆盖参考 | `BLENDER_5_2_WEB_FEATURE_PARITY.md`、`BLENDER_5_2_FULL_PARITY_WBS.md` |
|
||
|
||
## 其他文档
|
||
|
||
- `web/`：部署、CI、依赖、协议和已知限制等稳定合同。
|
||
- `status/`：每个已完成或阻断任务的证据记录，不作为下一任务的唯一上下文。
|
||
- `tasks/`：当前及近期任务卡；完成后保留，便于审计和回滚。
|
||
- 根目录路线图和 `后续工作.txt`：历史设计与决策背景，不参与当前任务领取。
|
||
|
||
## 最小上下文规则
|
||
|
||
默认只加载本页列出的四个入口文件；实现细节按任务卡的文件清单追加读取。不要为了确认一个
|
||
局部输入、IO 或安全任务而加载整份 `PROJECT_STATUS_AND_NEXT_WORK.md` 或完整 parity 计划。
|
||
|
||
文档描述与 manifest/evidence 冲突时，以可复验的机器状态为准；不要通过修改 Markdown
|
||
checkbox 覆盖失败证据。
|