3.0 KiB
3.0 KiB
文档导航
本目录按“产品契约、当前任务、实现事实、长期规划、验收证据”分层。领取任务时不要从仓库根目录
开始通读；只读取当前队列和机器生成的最小上下文包。预算和自动检查见
CONTEXT_BUDGET.md。
完整拆分、预算、交接和提交规则见 CONTEXT_GOVERNANCE.md。
领取任务
- EXECUTION_QUEUE.md：唯一的短周期入口和当前指针。
node tools/web/print-task-context.mjs：只输出当前任务需要的四份输入。tasks/<task>.md：当前任务唯一的范围、输入和验收；缺卡时先修复生成流程，不要打开完整 plan。- parent
tests/golden/<parent>/manifest.json与status/<parent>.md：只提供交接事实。
需要拆分实施或控制上下文时，先看 CONTEXT_GOVERNANCE.md； TASK_BREAKDOWN.md 只提供阶段地图和归档示例，不覆盖 manifest/status 的机器事实。
任务卡使用 TASK_CONTEXT_TEMPLATE.md 的固定结构；卡片只描述一个主要
行为或一个证据变化，不复制实现日志。全量 gap 计划由机器索引切片，check-task-context 会阻止
超预算、缺卡、过期索引或 parent 指针错误进入队列。
事实源
| 问题 | 文件 |
|---|---|
| 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：历史设计与决策背景，不参与当前任务领取。
最小上下文规则
默认只加载队列、当前任务卡、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 覆盖失败证据。