# reports/ — 过程件容器 `design/` 只放持久化设计文档与规范,过程件一律不放。过程件落本目录,**按「吸收即死」到期即死**。 ## 放什么 | 文件 | 内容 | 谁写 | |---|---|---| | `需求卡片-<批名>-<日期>.md` | 一个需求单位的实施文档(roadmap 迭代行里的「卡①②③」是需求单位,需求卡片是它的展开):目标与完成定义/设计事实源/现状事实/契约/范围边界/任务卡/验收闸/代拍板白名单/待裁点 | 写卡段(`req-card` 技能) | | `提案-*`/`需求澄清-*`/`审计-*`/`评估-*` | 设计讨论段的过程稿:提案备选案与淘汰依据、需求澄清结论、调研与审计读数。被需求卡片或 GDD 当裁决源引用时在册;结论落进权威文档后即可删,删它不需要再裁(§11 吸收即死) | 设计讨论段 | | `iter-实现报告-<日期>.md` | 各任务卡状态、实机目检总清单、遗留读数义务、实现决定记录(超白名单/超卡片明列范围事项的备案节,细则见 process-conventions §3 第 11 条) | 迭代批 | | `iter-反哺点-<日期>.md` | 需要写进 `design/` 权威文档的点,逐条列清"哪个文件哪一节、改成什么、依据是什么" | 迭代批 | | `iter-验收审计-<日期>.md` | 独立验收审计结果:逐行对照表核对、撤销证明抽查、未过项与例外及依据 | 独立审计方(未参与实现) | | `iter-<交付物名>-<日期>.md` | 需求卡片点名的其它交付物(例:`iter27-探针迁移对照-2026-10-14.md`=11 个探针的成员依赖面清单,已随迭代 27 收尾退役) | 迭代批 | ## 不放什么 - **不放设计结论。** 本目录的文件是"待处理的申请单",不是事实源。反哺点由你在会话中讨论定稿后, 另开文档批写进 `design/`,写完即可删除本目录对应条目。 - **不放图像载体。** png/jpg/svg 等图一律留 `artwork/`(2026-09-27 用户裁「审图只看一处」;熵增闸图像白名单不含本目录,放了判红)。`.html`/`.json` 这类报告渲染件允许作为报告的一种(2026-10-21 用户裁)。 - **不放进度状态。** 现在做什么看根 `roadmap.md` 顶部「当前位」节,待办与待裁看仓库根 `待办清单.md`(2026-10-18 用户裁:根目录会话状态文件已废除,本目录也不许兼做状态记录)。 ## 生命周期 一个迭代号一组文件,**所属迭代实现批合回 master 即死**(判据权威=doc-conventions §11:需求卡片与迭代产出物的死期都是合回那一刻,roadmap 对应行改填「已退役(git 历史可考)」保留字):反哺点须先由 `design/` 吸收落文,再连同卡片与本目录其余产出物一并删除,历史进 git commit log (与"历史决策记录只进 git log、不设决策文档"这条红线同口径)。退役执行=batch-closure 技能 (批后收尾与中间文档退役),删前先过 doc-conventions §11 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。