落文(反哺点 ①②③⑤⑥⑦⑧⑨⑭⑮,经用户逐条裁决): - 敌人系统.md:寻址词族「同坐标/坐标行集」改「同带键/带键行集」五处,大地精行示例改寻址键 (1, battle, 3) - 关卡节点地图.md v2.1→v2.2:Boss 描边改紫赤+深墨环(依视觉定稿 level-map);补实现语义三句(层距=BFS 层差/Boss 与候选节点双豁免恒显类型/可见性只算当前圈不累积记忆);递出物改关卡序号+节点深度;info_visible_layers 已落数据表现行值 2 - 关卡节点图生成.md v1.1→v1.2:产出约束五条→六条,新增「多终点深度互异」;岔路取舍补候选集豁免类型可见性已兑现;调参表补图包络行(≤屏预算,超预算只限参数档) - level-map.md:信息层级第一层补类型可见性指针;画布公式记数订正(宽 70+层深×122+44.5、高 52+槽位×58+25+24,下限 620×256)——定稿语义不动 - 术语表.md:新增「关卡与地图」节,收「信息迷雾」(与视野迷雾区分,标识符禁 fog_ 前缀) - test-conventions.md §9.4:补「判据绑可观测提交面」一条,来源=迭代 34 探针首版假绿的教训(吸收原卡片 T2 描述项) ⑬ 超预算图策略无设计落点 → 待办清单新登记条目(设计面=文档轨,状态=待文档设计) ⑯ 卡片 T2 接口描述订正 → 判由 ⑭ 吸收,卡片随批退役不改 代拍板:迭代 34 两份代拍板单十三项(卡③ 六项+卡④ 七项,含卡④第 7 项白名单外甲案返工)用户全部追认,异议窗口关闭。 退役(吸收即死):reports/ 下迭代 34 产出物七份(实现报告/代拍板/反哺点清单/验收审计四份)+两份需求卡片。引用面已改写,doc_link 死链检查绿。 账面:roadmap 迭代 34 行改「已完成(2026-10-22)」、卡片列与实现报告列填「已退役(git 历史可考)」;顶部当前位迭代位与下一步换代。待办清单删迭代 34 两卡行、关卡节点图重构条设计定稿版本升 v1.2/v2.2、新登超预算图条目。体验验证清单登记 ㉜ 迭代 34 实机目检四项(不阻塞)。 域判定:diff 全部落在 design/+reports/+两份根流程清单+roadmap.md,纯文档域,故取 --docs 回执。零游戏测试执行(测试两入口铁规),结论均为静态核对。 已知缺口(不在本批修):待办清单从未设迭代 34 反哺点专条,落文凭据无处登记;roadmap 迭代 35/36 行仍写「待开工」与实际不符(35 卡①已合回、卡②停机;36 三卡已合回并收尾),留待用户发令订正。
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 判据。验收审计报告随实现报告同批退役(结论已并入实现报告)。