反哺点落文(用户 2026-10-25 逐条裁「全部照此落文」):卡①① 多终点深度互异改「互异节点深度」并补深度算法(最长路径、多入口取最长、不取最短的理由);卡①⑦ 增「支路互异上限=出口数 3」摆放约束;卡①②/卡②① 地图深度定义改最长路径、三处「节点编号」换「节点深度」;卡①③/卡②② 冒险结构覆盖义务换代为敌侧带命中+板侧解析命中+深度域 L1 0–6/L2 0–9/L3 0–13,删「旧模板池随实现批清数据」;卡①④/卡②④ level-map 登记生成图随动——入口停点候选数=入口个数、节点数字=图内句柄 id、L3 深度域超出冻结画布约 10 层屏预算(等比缩放/滚动视口两案未裁,只登记缺口);卡②③ 核对无用语漂移。版本:生成 v1.3、地图 v2.3、level-map Last Updated 2026-10-25。 代拍板:卡① 六条+白名单外两件、卡② 六条+超清单五件,按用户令整单追认(推翻项零)。 中间文档退役十二份(吸收即死):两张需求卡片、两卡实现报告/代拍板/反哺点/验收审计共八份、两份停机呈报;引用面已改写(待办证据指路改 git 提交 5499eb9c)。目检四条迁体验验证清单 ㉝。 账面换代:roadmap 迭代 35 行改「已完成(2026-10-25)」、卡片与实现报告列填退役保留字,顶部当前位三行换代;待办清单 06「关卡节点图重构」条目整条删除(完成即删),新增三条代码件待办(验证集清单重生成、测试宿主改名、level.tres 表尾叙事订正),图包络条目同步 v1.3 引用与实测越界事实。 本批为文档批:零 game/ 改动、零测试执行、零 MC。
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 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。