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
+9
-8
@@ -15,15 +15,15 @@
|
||||
- [`../AGENTS.md`](../AGENTS.md):Codex / 通用 AI coding agent 的仓库级入口。
|
||||
- [`../CLAUDE.md`](../CLAUDE.md):Claude Code 的薄入口,具体规则以 `AGENTS.md` 为准。
|
||||
- [`../tasks.md`](../tasks.md):当前样本库自身的维护任务列表,不是复制到新项目后的业务任务看板。
|
||||
- [`../progress.md`](../progress.md):复制到新项目后的执行历史流水,只追加记录任务执行、验证、阻塞和决策。
|
||||
- [`../progress.md`](../progress.md):可选历史归档 / 项目级大事记;执行记录默认写各任务文件的 `## 执行记录`。
|
||||
- [AI 开发入口](00-ai-start-here.md):agent 每次开始工作的入口、阅读顺序和任务领取规则。
|
||||
- [项目愿景](01-vision.md):为什么做、为谁做、产品原则、非目标。
|
||||
- [需求](02-requirements.md):要什么、用户故事、验收标准,不写技术实现。
|
||||
- [技术栈](03-tech-stack.md):确定使用哪些框架、库、数据库、部署方式。
|
||||
- [架构设计](04-architecture.md):系统结构、模块职责、数据模型、关键风险和开发顺序。
|
||||
- [编码规则](05-coding-rules.md):AI 写代码前必须遵守的硬约束。
|
||||
- [任务看板](06-tasks.md):按依赖拆分的小任务,agent 每轮只做一个(单 agent / 小项目)。
|
||||
- [任务文件(多 agent 并发)](tasks/README.md):一任务一文件 `docs/tasks/T-<编号>.md`,多 agent 并发时避免抢改同一看板/进度文件。
|
||||
- [任务路线图](06-tasks.md):阶段划分、里程碑和待办池;只读,不跟踪单任务状态。
|
||||
- [任务文件(默认)](tasks/README.md):一任务一文件 `docs/tasks/T-<编号>.md`,任务状态以 frontmatter 为准,单/多 agent 通用,agent 每轮只做一个。
|
||||
- [已有项目接入清单](adoption-checklist.md):把本模板补进已有代码库时的迁移步骤和第一轮任务建议。
|
||||
- [API 合约](api.md):前后端接口形状、错误格式、鉴权约定。
|
||||
- [路由与页面结构](routes.md):页面路由、页面职责、组件归属。
|
||||
@@ -36,15 +36,16 @@
|
||||
|
||||
## 任务 / 进度 / 当前状态
|
||||
|
||||
- `06-tasks.md` 维护任务看板:任务 ID、依赖、验收要点和状态。
|
||||
- `../progress.md` 维护执行进度:每轮实际做了什么、跑了什么验证、遇到什么阻塞、做了什么决策。
|
||||
- `current-state.md` 维护当前快照:当前目录、当前可运行命令、已完成任务摘要和下一个可领取任务。
|
||||
- `tasks/`(`docs/tasks/T-<编号>.md`)维护任务:规格、依赖、状态(frontmatter)和执行记录,一任务一文件。
|
||||
- `06-tasks.md` 维护路线图:阶段划分、里程碑和待办池,不跟踪单任务状态。
|
||||
- `current-state.md` 维护当前快照:当前目录、当前可运行命令、任务摘要和下一个可领取任务。
|
||||
- `../progress.md` 可选:历史归档或项目级大事记,不逐任务追加。
|
||||
|
||||
如果新项目希望任务看板放在根目录,可把 `06-tasks.md` 复制或改名为根目录 `tasks.md`,并同步更新本文、`00-ai-start-here.md` 和 `current-state.md` 的链接。已有项目接入时,先读 `adoption-checklist.md`,不要直接领取新功能。
|
||||
已有项目接入时,先读 `adoption-checklist.md`,不要直接领取新功能。
|
||||
|
||||
## 维护原则
|
||||
|
||||
- 需求变化先改文档,再改代码。
|
||||
- 代码现实变化后同步 `current-state.md` 和 `06-tasks.md`,执行过程追加到 `../progress.md`。
|
||||
- 代码现实变化后同步 `current-state.md`;任务状态改在对应任务文件 frontmatter,执行过程写进该任务文件的 `## 执行记录`。
|
||||
- API、数据模型、路由、技术栈一旦在文档中定稿,代码不得另起一套。
|
||||
- agent 开始新任务前,必须从 `00-ai-start-here.md` 进入。
|
||||
|
||||
Reference in New Issue
Block a user