# Plan（计划）

`docs/staging/plans/YYYY-MM-DD-<topic>.md`。引用规范；不要复述。

如果未解决的规范笔记影响实现或任务顺序，回到 `design`。

## 里程碑任务（30-60 分钟每个）

每个任务是 `- [ ] T<n>: <名>` —— 总是复选框，不是标题。`tdd`/`subagents` 完成时改为 `- [x]`；`ship` 拒绝运行直到所有 `- [ ]` 完成。

```
goal:       <一句话>
files:      <路径>
acceptance: <测试或命令>
spec:       <docs/staging/specs/...#anchor>
```

无精确代码。无步骤。Acceptance 可执行：测试名、命令或脚本检查。每个任务留下仓库是绿色的。

标记独立任务：`[parallel] T3, T4, T5`。

仅当共享契约、状态、错误和 acceptance 闭合时标记 `[parallel]`。

**原子展开在分派时推迟** - `subagents` 在分派时将里程碑展开为 2-5 分钟步骤，不在这里。

**新项目**：派生初始化任务 —— 搭脚手架代码、测试、CI，总是包括：`README.md`、`CHANGELOG.md`、`.gitignore` 和 `Makefile`（或等价的任务运行器配置）。

## 不要放在计划里

背景、架构、理由（规范）、CI 命令、复制粘贴的 acceptance。

## 滚动波浪

规范有 `## Roadmap`？仅展开标记为 `← 现在详细计划` 的里程碑。留下其他的为 stub。

`ship` 后：把 `← 现在详细计划` 标记移到下一个里程碑（改它的 `← stub` 为 `← 现在详细计划`），根据你学到的更新它，然后展开它。仅当里程碑目标实质改变时回到 `design`。

## Gate

`docs/staging/plans/YYYY-MM-DD-<topic>.md` 必须存在于磁盘前移交给 `tdd`/`subagents`。

与用户确认计划。

多数 `[parallel]` → `subagents`。否则 → `tdd`。