Files
gplan-2/reports
DKChan 7493aebca8 chore(文档缺陷订正与机检补件): 四份根文件用词与死指订正+新增引用可核机检件
修文档缺陷四处: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 条未命中(约七成噪声),
按建议级交付不判红。文档域闸全绿。
2026-10-21 05:51:17 +08:00
..

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 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。