# 文档导航

本目录按“产品契约、当前任务、实现事实、长期规划、验收证据”分层。领取任务时不要从仓库根目录
开始通读；只读取当前队列和机器生成的最小上下文包。预算和自动检查见
[`CONTEXT_BUDGET.md`](CONTEXT_BUDGET.md)。
完整拆分、预算、交接和提交规则见 [`CONTEXT_GOVERNANCE.md`](CONTEXT_GOVERNANCE.md)。

## 领取任务

1. [EXECUTION_QUEUE.md](EXECUTION_QUEUE.md)：唯一的短周期入口和当前指针。
2. `node tools/web/print-task-context.mjs`：只输出当前任务需要的四份输入。
3. `tasks/<task>.md`：当前任务唯一的范围、输入和验收；缺卡时先修复生成流程，不要打开完整 plan。
4. parent `tests/golden/<parent>/manifest.json` 与 `status/<parent>.md`：只提供交接事实。

需要拆分实施或控制上下文时，先看 [CONTEXT_GOVERNANCE.md](CONTEXT_GOVERNANCE.md)；
[TASK_BREAKDOWN.md](TASK_BREAKDOWN.md) 只提供阶段地图和归档示例，不覆盖 manifest/status 的机器事实。

任务卡使用 [TASK_CONTEXT_TEMPLATE.md](TASK_CONTEXT_TEMPLATE.md) 的固定结构；卡片只描述一个主要
行为或一个证据变化，不复制实现日志。全量 gap 计划由机器索引切片，`check-task-context` 会阻止
超预算、缺卡、过期索引或 parent 指针错误进入队列。

## 事实源

| 问题 | 文件 |
| --- | --- |
| 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`：历史设计与决策背景，不参与当前任务领取。

## 最小上下文规则

默认只加载队列、当前任务卡、parent manifest 和 parent status；总量上限为 3,500 tokens。
实现细节按任务卡的文件清单追加读取。不要为了确认一个局部输入、IO 或安全任务而加载整份
`PROJECT_STATUS_AND_NEXT_WORK.md` 或完整 parity 计划。

`next-task-plan.json`、parity map 和 gap audit 是生成器输入，不是任务上下文；任务工具只读取
带 hash 的单行 catalog 记录。

文档描述与 manifest/evidence 冲突时，以可复验的机器状态为准；不要通过修改 Markdown
checkbox 覆盖失败证据。