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 判据。