docs(tasks): make one-task-per-file the default task mode (H-409)
- docs/tasks/README.md: default mode for single and multi agent, drop switch narrative - docs/06-tasks.md: demote to read-only roadmap (phases, milestones, backlog, suggested split list without status) - progress.md: optional archive / project-level event log; execution records live in task files - current-state.md: project-level snapshot; task status authoritative in task frontmatter - sync all referencing docs (start-here, coding-rules, READMEs, adoption/clean-state checklists, method-map, evaluator-rubric) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Fable 5
parent
58ebb1fe26
commit
795a852aa9
+15
-17
@@ -1,31 +1,29 @@
|
||||
# 执行进度记录
|
||||
# 执行进度记录(可选 · 历史归档)
|
||||
|
||||
> 本文件是只追加的历史流水,用来记录任务执行过程、验证命令、阻塞点和关键决策。
|
||||
> 当前目录、当前命令、下一个可领取任务等可覆盖快照,写入 [`docs/current-state.md`](docs/current-state.md)。
|
||||
> **默认模式下本文件是可选工件**:执行记录写进各任务文件(`docs/tasks/T-<编号>.md`)的 `## 执行记录`,本文件不逐任务追加,约定见 [`docs/tasks/README.md`](docs/tasks/README.md)。
|
||||
> 保留本文件的两个用途:① 归档采用一任务一文件之前的历史流水;② 可选记录跨任务的项目级大事记(阶段切换、重大决策、事故复盘)。
|
||||
|
||||
## 职责边界
|
||||
|
||||
- `docs/06-tasks.md`:任务看板,维护任务状态、依赖和验收要点。
|
||||
- `progress.md`:历史流水,只追加记录每轮执行发生了什么。
|
||||
- `docs/current-state.md`:当前快照,可覆盖更新仓库现实、可运行命令和下一步。
|
||||
- `docs/tasks/T-<编号>.md`:任务规格、状态(frontmatter)和执行记录,任务级事实以此为准。
|
||||
- `docs/06-tasks.md`:只读路线图(阶段划分、里程碑、待办池)。
|
||||
- `docs/current-state.md`:当前快照,可覆盖更新仓库现实、可运行命令和 blocker。
|
||||
- `progress.md`(本文):可选历史归档 / 项目级大事记,不维护任务状态,不逐任务追加。
|
||||
|
||||
不要在本文重复维护当前目录结构、当前运行命令或下一个任务;这些信息以 `docs/current-state.md` 为准。
|
||||
|
||||
## 记录格式
|
||||
## 记录格式(如启用大事记)
|
||||
|
||||
每完成或中断一轮任务,在文件末尾追加一条记录:
|
||||
记录项目级大事记时,在文件末尾追加:
|
||||
|
||||
```markdown
|
||||
## 【YYYY-MM-DD】T-【编号】 【任务名】
|
||||
## 【YYYY-MM-DD】【事件 / 决策标题】
|
||||
|
||||
- 状态:【DONE / BLOCKED / PARTIAL】
|
||||
- 变更:【修改了哪些文件或模块】
|
||||
- 验证:【运行的真实命令和结果】
|
||||
- 阻塞:【如有,写明原因和需要谁决策】
|
||||
- 决策:【如有,记录本轮确定的关键取舍】
|
||||
- 下一步:【建议下一个任务 ID 或待确认事项】
|
||||
- 类型:【阶段切换 / 重大决策 / 事故复盘 / 其他】
|
||||
- 内容:【发生了什么、为什么】
|
||||
- 影响:【对后续任务或架构的影响】
|
||||
```
|
||||
|
||||
## 执行记录
|
||||
## 历史归档
|
||||
|
||||
<!-- 新项目开始后,从这里向下追加记录。 -->
|
||||
<!-- 采用一任务一文件之前的历史流水保留在此;新的执行记录写进各任务文件的 ## 执行记录。 -->
|
||||
|
||||
Reference in New Issue
Block a user