DKChan
c25daa30cd
反哺落文（reports/iter37-反哺点 逐条出账，清单随批退役）： - architecture.md v1.12→v1.13：模块归属表登记迭代37拆件新模块（CurioDeck/ShopSession/board_resolvers/main_ui_build/main_adventure_flow/main_overlay_flow/main_debug_flow/TilePalette/HeroSprite/BoardWorld 在册补行＋HudPresenter 数据投影＋文案拼装静态族加注；表内原无 HudPresenter 行，按新增落表）。 - 存档序列化.md：断点域豁免段注记 27 顶层键登记单源＝core/adventure_runner.gd const BREAKPOINT_FIELDS（写侧 _bp_parts()、读侧 _bp_read/_bp_read_int）。 - 冒险结构.md 共享池账本节：载体注记 AdventureRunner._bonus_deck→CurioDeck（池与判定）＋ShopSession（货架/定价/购买/刷新），规则文字零改动。 - code-conventions.md §1.1：新立拆分判据硬纪律——重构卡禁为迎合机检计数保留无效成员/别名，机检键与卡片契约互斥时实现段停卡呈报（反哺条7＋条9口径同落；行访问器直读=db即ConfigDB，口径由该条与既有数值单点纪律覆盖）。.zcode/.qoder 两份 req-card 技能同步第13项。 - game/tests/验证集清单.md：extract_checks.py --extract --force 重生成（64源1583调用点）；〔wr2〕三条走 check_quiet 通道不在提取器现行口径（旧清单同口径零条），属工具覆盖面既成事实，未扩口径。 - 反哺条4/10 批内已执行、条8 无义务、条5/6 分别由本批重生成/转待办新条出账。 代拍板：B-1~B-8 由用户 2026-10-25 结项发令整单追认（E-1/E-2 补救已入账于 P0 待办条）。 账面换代：roadmap 迭代37行＝已完成（2026-10-25）＋卡列/报告列退役保留字＋当前位三行换代；待办清单删「game代码结构审查批」条（未决六小件迁「结构审查未立项小件候审」、gdstyle基线陈旧键迁新条）、P0「AdventureRunner职责真拆分」吸收拆分卡缺口件（撤装置计数读数/五件收编范围/验收面预案）；体验验证清单录迭代37实机目检七条。 退役九件（判据逐份核对，引用面改写后 git rm）：iter37 产出物五份（代拍板/反哺点/实现报告/拆分卡缺口/验收审计）＋四张需求卡片（迭代已完成，roadmap 已填退役保留字）。
reports/ — 过程件容器
design/ 只放持久化设计文档与规范，过程件一律不放。过程件落本目录，按「吸收即死」到期即死。
放什么
| 文件 | 内容 | 谁写 |
|---|---|---|
需求卡片-<批名>-<日期>.md |
一个需求单位的实施文档（roadmap 迭代行里的「卡①②③」是需求单位，需求卡片是它的展开）：目标与完成定义／设计事实源／现状事实／契约／范围边界／任务卡／验收闸／代拍板白名单／待裁点 | 写卡段（req-card 技能） |
提案-*／需求澄清-*／审计-*／评估-* |
设计讨论段的过程稿：提案备选案与淘汰依据、需求澄清结论、调研与审计读数。被需求卡片或 GDD 当裁决源引用时在册；结论落进权威文档后即可删，删它不需要再裁（§11 吸收即死） | 设计讨论段 |
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/，写完即可删除本目录对应条目。 - 不放图像载体。 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 判据。验收审计报告随实现报告同批退役（结论已并入实现报告）。