diff --git a/CLAUDE.md b/CLAUDE.md index 197fe073..1b7e60e7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -52,7 +52,7 @@ | 架构与决策记录 | `design/dev/architecture/architecture.md` + 同目录 `adr-*.md` | | 引擎版本与参考 | `design/dev/engine-reference/godot/`（版本表已在上方 @ 引入） | | 术语、已锁数值 | `design/registry/entities.yaml`——仅 owner 文档可修订，冲突须显式提出 | -| 会话进度记录 | 根目录 `active.md`——顶部「当前状态快照」节 + 批次台账；收口先改快照再记账，每条 ≤3 行，详情外链 | +| 会话进度记录 | 根目录 `active.md`——顶部「当前状态快照」节 + 批次台账；收口先改快照再记账；条目用完整白话句子写清结论，能看懂比短重要（2026-10-04 用户立规），详情归正主文档 | | 工程路线图 | 根目录 `roadmap.md`——里程碑时间线与下一步顺序（批级视图；实时状态看快照节） | ## 分支纪律（worktree 铁律，2026-09-19 用户立规） diff --git a/design/dev/doc-conventions.md b/design/dev/doc-conventions.md index 13edc98d..03478ac2 100644 --- a/design/dev/doc-conventions.md +++ b/design/dev/doc-conventions.md @@ -150,7 +150,7 @@ ## 10. 会话记录纪律 -根目录 `active.md`（会话快照+批次台账）每条进度 ≤3 行（粗体键 + 短句）；详情一律外链到对应文档或报告，禁止把定稿摘要、义务清单整段塞进条目。台账条目记裁决结论本身，不记中间文档文件指针（见第 11 节）。 +根目录 `active.md`（会话快照+批次台账）每条进度用完整的白话句子写清结论本身；条目写多长以读者能看懂为准，不设行数上限（2026-10-04 用户立规：能看懂比字数少更重要，原「每条 ≤3 行」约束废除——该约束曾迫使台账压缩成只有作者自己懂的自造缩略语，是文档黑话的繁殖地）。仍然禁止的只有两件：把定稿摘要、义务清单整段搬进条目（详情归各正主文档，台账只记结论）；以及自造黑话——第 4 节用语纪律对台账同等生效。台账条目记裁决结论本身，不记中间文档文件指针（见第 11 节）。 ## 11. 文档生命周期：吸收即死（2026-10-01 用户立规） @@ -184,3 +184,4 @@ | v7 | 2026-09-16 | 06 清单改版（用户拍板）：「待拍板」术语全仓改「待办」，清单更名 `design/gdd/06-待办清单.md`；清单内格式由四列表格改为「循环 → 系统 → 条目（四级标题）+ 粗体属性段（现状 / 归属 / 状态）」，条目解决后状态改"已解决（日期）"留痕；第 6 节顶层文档表与骨架表、第 8 节「待办单点登记」同步改指 | | v8 | 2026-09-30 | **概念落位与口径携带条款（微光口径事故后补成，用户拍板）**：第 7 节概念封装纪律增「落位五要素」行（定义/作用对象与范围/生命周期/关联/状态缺一不立）与「无正主，不下定义」段（概念未落正主前，任何文档不得替它下定义，只许 06 登记「待落位」）；第 8 节「引用不转述」行扩口径携带纪律（作用对象/范围/生命周期随句写全或显式指路，禁裸形容词复述） | | v9 | 2026-10-02 | **文档生命周期条款（2026-10-01 用户立规「吸收即死」落文）**：新增第 11 节——中间文档寿命=迭代寿命，结论吸收进正主即删、未决先迁再死、永不入库、引用面口径、台账记结论不记指针、sim-data 白名单、迭代出口清理项、design/research 与 design/qa 为暂存地非档案库；第 10 节补台账记结论口径；文首地位/适用范围两处过期路径修正（`docs/`→`design/dev/`、`production/` 会话记录→根 `active.md`） | +| v10 | 2026-10-04 | **台账去压缩条款（用户立规）**：第 10 节废除「每条 ≤3 行」——能看懂比字数少更重要；条目改用完整白话句子写结论，长度服从可读性；第 4 节黑话禁令对台账同等生效。起因：2026-10-04 黑话审计证实 ≤3 行压缩压力迫使台账条目使用自造缩略语（收口/落籍/在飞等约 15 个流程动词、530 条自造短语），并渗入正式文档；CLAUDE.md 规范导航表「会话进度记录」行同步改写 |