c9db9f7d36
确立 docs/architecture 为设计/现状唯一真源,agent-specs 仅留正在演进的设计。 回灌核对(review §2.4)后将 18 份「已迁入 architecture 或纯留痕」的设计/过程档 git mv 进 _archive(各带 SUPERSEDED tombstone 指新落点);生成域在飞设计链 (架构演进路线/生命周期范式/多session总账/任务普查)+ 3 待定档暂留,待二次收尾。 - 归档 18 档:SAA编排/引擎运行时/验收门/prompt治理(settled 底座,内容在子树) + WG1/设计裁决/OpenGame/开闸接线/固定架构review/传承演进/并行编排(已迁子树) + 完成度总账(FOLD 进需求模块映射)+ SAA-dossier残留 + 根因复盘/目录治理/ 深度重构plan/文档整理plan/planB-closeout(纯留痕) - 清 7 处死引用:5 处 .agents/plans 旧 agent-specs 路径→新树 + 2 处 architecture 树内回链(开闸接线/观测体系→验收门新树路径) - 修 7 处归档连带死链(指已归档档→新树现行档 或 _archive 留痕) - _index 补 2026-06-22 收尾 banner + 6 处指针改新树/_archive - 死链门 check-deadlinks.sh = 0;收尾清单 docs/plans/2026-06-22-域化重构收尾清单.md 待二次收尾(创始人选保守暂留):总体架构-review/固定架构-execution/产品开发路线图 (architecture 仍当其权威源回链,需先补迁详义)+ 对话素材v1(留痕,牵连保留档链接) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
8.3 KiB
8.3 KiB
date, topic, status
| date | topic | status |
|---|---|---|
| 2026-06-22 | 设计文档域化重构 · 收尾清单 | 待创始人确认边界后执行 |
设计文档域化重构 · 收尾清单（待创始人确认边界）
这是什么
2026-06-20 的"设计文档域化重构"（把设计文档的唯一真源从 docs/agent-specs/ 迁到
docs/architecture/ 六域树）已经执行了约八成：docs/architecture/ 的六域树、散文版总索引、
生成引擎旗舰子树（19 个子档）都已建好并填充，治理规则 engineering-conventions §10 也已把
architecture 立为 canonical 根、把 agent-specs 降为"留痕 + 生成域过渡期"。纯 settled 域
（变现 / 渠道 / 战略合规 / studio 前端）的原档此前已经归档。
唯一没收尾的，是生成域那批原档——因为它在治理规则里被定性为"架构演进中·过渡期保留"， 所以一直堆在 agent-specs 顶层。本清单是一次回灌核对（review §2.4 的收尾必经门）的结果： 逐档实证核对每份原档的内容是否已被 architecture 对应档充分吸收，据此判定归档 / 保留 / 待定。
一个必须先看到的结构事实
architecture 树目前并不完全自洽：它的总索引 README.md §9 仍把三份现行权威源回链指回
agent-specs——2026-06-12 总体架构-review、生命周期项目管理-review(v2)、生成主线架构演进路线。
也就是说，"architecture 是唯一真源"这句话现在还有缺口：一部分现行真相的正本仍住在 agent-specs。
收尾要么把这些内容补迁进 architecture 让它真自洽，要么明确承认"生成域在飞、SoT 暂留 agent-specs"
是一个有意的过渡态。这是下面"待你拍板"两个方案的根。
处置清单（agent-specs 顶层 28 个 .md，_index.md 除外）
A. 建议归档（内容已被 architecture 充分吸收，或属纯留痕）——15 档
| 文件 | 落点 / 理由 |
|---|---|
prompt治理体系-execution.md |
→ 架构/生成引擎/prompt治理.md（第8契约/四道闸/HITL 已写入，落点已纠偏陈腐 Dify/OpenGame） |
2026-06-13-WG1-20经典轻游戏基准-review.md |
→ 架构/生成引擎/WG1基准.md（20款靶集/4类缺口已迁，落点更新） |
2026-06-20-生成设计合理性-对抗审查裁决.md |
→ 架构/生成引擎/设计合理性裁决.md（4结论+四改已迁） |
2026-06-20-OpenGame对照分析与复刻缺口.md |
→ 架构/生成引擎/OpenGame对照.md（4工具/六阶段/3缺口已迁） |
2026-06-17-开闸-一句话入口接线-review.md |
→ 架构/生成引擎/开闸接线.md（两门焊死/generic 归一已迁） |
2026-06-17-固定游戏架构与SAA-agentic-studio-review.md |
→ 架构/生成引擎/固定游戏架构.md（配套设计 review，内容已迁，无独立现行内容） |
2026-06-16-生成引擎主线-传承与演进-review.md |
换框架核验账，现行价值已并入 SAA编排.md §9 + 演进路线 |
2026-06-16-生成引擎-并行编排.md |
档首已标 SUPERSEDED→多session总账（模块切分版作废，留桩） |
2026-06-20-架构错误根因复盘-report.md |
复盘留痕，修复已落 AGENTS §6 + conventions §10.7 |
2026-06-16-agent-specs目录治理-review.md |
治理留痕，已收口，被本次重构连锁取代 |
2026-06-17-agent-specs深度重构-plan.md |
治理留痕，被本次重构 review §6 明列取代 |
2026-06-17-文档整理-plan.md |
doc-organizer 一次性清理计划，纯过程稿 |
2026-06-17-产品功能与技术模块-完成度与优先级总账.md |
→ 产品/需求模块映射.md §完成度快照 + 架构/13模块.md §4（155×13 forensic 已 FOLD，且比源档新） |
2026-06-15-SAA-能力API接入-dossier.md |
→ 架构/生成引擎/SAA能力API-dossier.md（244行，更全；顶层这份是迁移后残留副本。⚠️ _index §3 仍标 KEEP=stale，同步） |
2026-06-21-planB-phase2-closeout.md |
Plan B Phase-2 收口报告，纯收口留痕 |
B. 建议归档但须先改回链（生成域 settled 底座，子树已吸收，但有档把它当权威源）——3 档
| 文件 | 落点 | 归档前置 |
|---|---|---|
agentic编排-SAA.md |
→ 架构/生成引擎/SAA编排.md |
改 .agents/skills/saa-graph-orchestration.md + docs/plans/2026-06-18-001 共 3 处回链 |
引擎与运行时.md |
→ 架构/生成引擎/引擎与运行时.md |
无残留回链，可直接归 |
开闸验收门-W-G1.md |
→ 架构/生成引擎/验收门-W-G1.md |
改 architecture 树内 开闸接线.md:115 + 运维/观测体系.md:121 两处回链 |
C. 保留（正在演进 / 活跃账 / 任务 SoT）——5 档
| 文件 | 保留理由 |
|---|---|
生成主线架构演进路线.md |
★ 现行 SoT·status 待评审；README §9 + SAA编排/OpenGame对照多处当权威源回链 |
2026-06-17-生成主线-游戏生命周期项目管理-review.md(v2) |
★ ACTIVE 范式基座；README §9 当权威源回链；子树只摘 §3 未全迁 |
2026-06-17-多session分工与任务总账.md |
★ 活跃协作总账，三 session 派活先读；协调账非设计内容，无 architecture 落点 |
2026-06-16-生成引擎-任务清单普查.md |
活跃任务 SoT，持有未迁 open 任务（D9/D11/D12/GP9/2安全洞）；归档前须先迁 open 项否则丢任务 |
2026-06-20-设计文档域化重构-review.md / -execution.md |
本重构自身档，收口后一并归档（合计 2 档，未计入上方数字） |
D. 待你拍板（architecture 仍把它当权威源 / 落点缺失，贸然归档会留悬空 SoT）——3 档
| 文件 | 问题 |
|---|---|
2026-06-12-游戏生成系统总体架构-review.md |
README §9 标它为"三级生成/29条意图覆盖矩阵"的 §8 权威源，README §8 只搬骨架、详义仍指回原档。归档会留悬空引用，须先把详义全文迁入子树 |
2026-06-17-固定游戏架构与SAA-...-execution.md |
硬事实层已吸收进 固定游戏架构.md，但字段级 schema 有意外置，SAA编排.md:317 等两处当权威源并列回链；需定：字段细节归 contracts/（则可归档为 trace）还是该档保留 |
2026-06-16-产品开发路线图-review.md |
三阶段产品形态/Phase 0-4 排期/三线分工，在产品域与运营域均无落点；要么补迁产品域，要么确认是一次性产品决策 trace 可归档 |
待清的死引用（5 处真死引用 + 2 处 architecture 树内连带）
真死引用（指向即将归档的 4 档，新路径已存在）：
.agents/skills/saa-graph-orchestration.md行4（→SAA编排.md）、行5（→SAA能力API-dossier.md）.agents/skills/prompt-governance.md行3（→prompt治理.md）.agents/skills/ai-generation-pipeline.md行78（→prompt治理.md）docs/plans/2026-06-18-001-...-plan.md行172（→SAA编排.md）
architecture 树内连带（B 组归档时一并改）：
架构/生成引擎/开闸接线.md:115、运维/观测体系.md:121（→验收门-W-G1.md 新树路径）
engineering-conventions.md 内提及 agent-specs 的均为治理正文（描述其降层角色），无需改。
两个收尾方案（待你选）
- 方案一·保守（推荐）：本次只归档 A+B 共 18 档 + 清 5 处死引用 + 改 B 组回链；生成域里 仍在演进/被回链当 SoT 的（C 组 + D 组）全部暂留，等生成域架构定稿（W-G1 开闸验收、tier2 spike 验完）再做第二次收尾。优点：不撞 Mac/他 session 在飞的生成域，零悬空 SoT 风险。
- 方案二·进取：连 D 组也处理——先把总体架构 §8 详义、固定架构字段 schema、产品路线图补迁进 architecture 让它真自洽，再归档，让 agent-specs 顶层只剩 C 组真在飞的 4 档。优点：一步到位、 architecture 彻底唯一真源；代价：要先写迁移内容，工作量更大，且碰生成域有撞 session 风险。
确认后的执行步骤（任一方案）
git mv归档源档进docs/agent-specs/_archive/，每档加 SUPERSEDED tombstone 指新落点；- 清 5 处死引用 + 改 B 组 2 处 architecture 树内回链；
- 跑
.agents/tools/check-deadlinks.sh= 0、rg旧路径机校 = 0； - 瘦身
_index.md（移除已归档档、同步 §3 SAA-dossier stale 标记）； - 按
.agents/skills/wave-close-checklist.md第 8 步对账 + commit + push。