DKChan
7493aebca8
修文档缺陷四处：AGENTS.md「收口」×2、「不得」×3 换白话；roadmap.md:87「对拍」「标旗」换代； reports/README.md 指向已迁移的 design/gdd/06-待办清单.md 改指仓库根；待办清单 iter19 遗留第⑦项 前半「数据配置.md:223 历史行死指」实查核销（该文件版本史行已随禁写变更记录规约消亡，现 212 行）。 补机检：tools/doc_ref_audit.py 核文档内「文件:行号」指针的目标存在性与行界，带扫描面为空与 引用数为零双自检；双向变异证据——注入不存在路径 EXIT=1、注入超界行号 EXIT=1、还原 EXIT=0。 doc_term 扫描面扩到四份根文件：扩面前实测这批文件自身含 3 处用语表废止词，先改现实再扩面， 扩面后「疑似现行」0、注入「完美排雷」见红 EXIT=1、还原 EXIT=0。 08d 引用可核暂不注册进闸壳：建档须改 game/tests/.gates/baseline.json，触 game/ 即要求代码域全量测试， 文档域批按测试两入口铁规零跑——注册欠账已登记待办清单。内容锚核对实测 81 处出 58 条未命中（约七成噪声）， 按建议级交付不判红。文档域闸全绿。
2.3 KiB
2.3 KiB
reports/ — 过程件容器
design/ 只放持久化设计文档与规范，过程件一律不放。过程件落本目录，按「吸收即死」到期即死。
放什么
| 文件 | 内容 | 谁写 |
|---|---|---|
需求卡片-<批名>-<日期>.md |
一个需求单位的实施文档（roadmap 迭代行里的「卡①②③」是需求单位，需求卡片是它的展开）：目标与完成定义／设计事实源／现状事实／契约／范围边界／任务卡／验收闸／代拍板白名单／待裁点 | 写卡段（req-card 技能） |
iter<N>-实现报告-<日期>.md |
各任务卡状态、实机目检总清单、遗留读数义务 | 迭代批 |
iter<N>-代拍板-<日期>.md |
批内 agent 替你拍的决定清单，等你追认或推翻 | 迭代批 |
iter<N>-反哺点-<日期>.md |
需要写进 design/ 权威文档的点，逐条列清"哪个文件哪一节、改成什么、依据是什么" |
迭代批 |
iter<N>-验收审计-<日期>.md |
独立验收审计结果：逐行对照表核对、撤销证明抽查、未过项与例外及依据 | 独立审计方（未参与实现） |
iter<N>-<交付物名>-<日期>.md |
需求卡片点名的其它交付物（例：iter27-探针迁移对照-2026-10-14.md＝11 个探针的成员依赖面清单，已随迭代 27 收尾退役） |
迭代批 |
不放什么
- 不放设计结论。 本目录的文件是"待处理的申请单"，不是事实源。反哺点由你在会话中讨论定稿后，
另开文档批写进
design/，写完即可删除本目录对应条目。 - 不放图。 图像白名单不含本目录，放了会被熵增闸判红。
- 不放进度状态。 现在做什么看根
roadmap.md顶部「当前位」节，待办与待裁看仓库根待办清单.md（2026-10-18 用户裁：根目录会话状态文件已废除，本目录也不许兼做状态记录）。
生命周期
一个迭代号一组文件，落档即死：反哺点被 design/ 吸收后，对应文件删除，历史进 git commit log
（与"历史决策记录只进 git log、不设决策文档"这条红线同口径）。退役执行=batch-closure 技能
（批后收尾与中间文档退役），删前先过 doc-conventions §11 判据。验收审计报告随实现报告同批退役（结论已并入实现报告）。