26 lines
1.6 KiB
Markdown
26 lines
1.6 KiB
Markdown
# reports/ — 迭代批的产出物存放处
|
||
|
||
迭代（代码实现）批**禁写 `design/` 整个目录**——那里是设计权威文档与规范，对实现批只读。
|
||
实现批自己要往外交代的东西，一律落在本目录。
|
||
|
||
## 放什么
|
||
|
||
| 文件 | 内容 | 谁写 |
|
||
|---|---|---|
|
||
| `iter<N>-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
|
||
| `iter<N>-代拍板-<日期>.md` | 批内 agent 替你拍的决定清单，等你追认或推翻 | 迭代批 |
|
||
| `iter<N>-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点，逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 |
|
||
|
||
## 不放什么
|
||
|
||
- **不放设计结论。** 本目录的文件是"待处理的申请单"，不是事实源。反哺点由你在会话中讨论定稿后，
|
||
另开文档批写进 `design/`，写完即可删除本目录对应条目。
|
||
- **不放图。** 图像白名单不含本目录，放了会被熵增闸判红。
|
||
- **不放进度状态。** 现在做什么看根 `roadmap.md` 顶部「当前位」节，待办与待裁看 `design/gdd/06-待办清单.md`（2026-10-18 用户裁：根目录会话状态文件已废除，本目录也不许兼做状态记录）。
|
||
|
||
## 生命周期
|
||
|
||
一个迭代号一组文件，落档即死：反哺点被 `design/` 吸收后，对应文件删除，历史进 git commit log
|
||
（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。退役执行=batch-closure 技能
|
||
（批后收尾与中间文档退役），删前先过 doc-conventions §11 判据。
|