文档导航
本目录按“产品契约、当前任务、实现事实、长期规划、验收证据”分层。领取任务时不要从仓库根目录 开始通读;只读取当前队列、当前任务卡和机器 manifest 指向的状态页。
领取任务
- EXECUTION_QUEUE.md:唯一的短周期入口,给出当前
nextTask和读取顺序。 tasks/<task>.md:当前任务的最小上下文、范围和验收命令。tests/golden/<task>/manifest.json:机器事实源,确认 parent、输入构件和下一个任务。status/<task>.md:完成后写入证据、hash、状态和回滚方式。
需要拆分实施或控制上下文时,先看 TASK_BREAKDOWN.md。它提供阶段地图、 原子任务门、当前 M14-04F 的子任务和后续任务草案,但不覆盖 manifest/status 的机器事实。
任务卡使用 TASK_CONTEXT_TEMPLATE.md 的固定结构;卡片只描述一个主要 行为或一个证据变化,不复制实现日志。
事实源
| 问题 | 文件 |
|---|---|
| V1 承诺、非目标、发布门 | WEB_BLENDER_MODELER_V1_SCOPE.md |
| 当前领取顺序 | EXECUTION_QUEUE.md + 当前 manifest 的 nextTask |
| 当前实现和风险 | PROJECT_STATUS_AND_NEXT_WORK.md |
| M12-M23 长期原子计划 | 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 覆盖失败证据。