跳到主要内容

<项目名> 架构重构复盘

工作流收尾时由维护者填写。本复盘的双重目的

  1. 沉淀本项目的工作流细节作历史可追溯
  2. 反馈给 commons/playbooks/architecture-document-rewrite.md,识别方法论改进点

第一部分:量化产出

类别产出
主架构文档<行数> 行 / <部分数> 部分 / <章节数> 节 / <Mermaid 图数> 张
Engineering pack(如已拆分)m{N}-*.md × N 份,合计 <行数> 行
架构决策(ADR)<已 accepted N>,<待写 N>
多 Agent ReviewR1 份 + R2 份 + 综合行动方案
上位文档对齐<战略白皮书 / 产品定义 修订项数量>
同位文档归档<被新架构吸收并归档的 v1 文档数量>
派生路由扩展<如本仓有派生脚本,列扩展项>
工作流时长(连续投入估算)<小时数>
工作流节点数<节点数>

第二部分:质量指标

指标数值说明
战略保真度 grep 命中(合法元引用除外)<数值>0 为优
实施新人 mental model 信心打分(R2 / 5)<数值>4.5+ 为优
工程化落地 Agent M0 完成度估算(R2)<%>80%+ 为优
三检 review gate 拦截能力评分(R2 / 10)<数值>7+ 为优
verify-kb 全程跑通<是 / 否>必须 100%
跨 Agent 三角验证 reviewer 数<数值>4+ 为充分

第三部分:五条核心范式实战检验

范式 1:工作流外化

实战表现:<本项目中本范式如何 work / 哪些操作奏效>

调整建议:<如有 — 写回 commons playbook 的反馈点>

范式 2:主架构 + 工程包双轨

何时拆分:<本项目在 Phase X 拆分,主架构达 X 行时>

拆分前 vs 拆分后 Agent context 占用:<X% → Y%>

调整建议:<如本项目需要变成三轨或其他形式 — 写回 commons playbook>

范式 3:多 Agent 跨视角三角验证

Reviewer 矩阵

轮次Reviewer视角关键发现
R1-A.........
R1-B.........
............

新增 / 调整的维度:<本项目特有的 review 维度 — 写回 commons playbook>

范式 4:草稿到合并 merge-script 模式

实战表现:<合并次数 / 是否零差错>

调整建议:<如有>

范式 5:战略保真度 + 写作纪律双轨

禁词清单(本项目特定):

  • <禁词 1>
  • <禁词 2>

写作纪律:<是否所有纪律都被遵守 / 哪些纪律易破>


第四部分:本项目特化的工作流时间线

节点关键事件经验教训
1工作流初始化<经验>
.........

完整时间线见 status.md 更新历史段。


第五部分:与 commons/playbooks/architecture-document-rewrite.md 的差异

5.1 完全沿用的部分

  • <11 Phase 流程 / 五范式 / 模板 等> — <沿用方式>

5.2 本项目特化的部分

  • 方法论组合调整:<本项目选了什么组合,与默认基线的差异>
  • 章节结构调整:<本项目实际章节数 / 部分数与典型项目的差异>
  • engineering-packs 切片方式:<本项目按什么维度切,与里程碑切的差异(如有)>
  • Review 维度调整:<本项目特有的 review 维度>

5.3 给 commons playbook 的反馈

下列建议提议写回 commons/playbooks/architecture-document-rewrite.md

  • 反馈 1:<建议描述>
  • 反馈 2:<建议描述>

反馈机制:通过 governance/change-protocol.md 流程评审 + 合并到 commons playbook。


第六部分:方法论的诚实声明(本项目实战版)

6.1 本工作流不能保证的事

  • <本项目实战中发现的局限>

6.2 残余风险

  • <尚未通过工作流彻底解决的风险,需后续工程实施 + 评估闭环承接的>

6.3 后续应承接的方法论改进

  • <识别出但本工作流未做的方法论改进点>

第七部分:下一步

本项目自身

  • M0 OpenSpec task packet 起草(非本工作流范围)
  • 工程实施仓 bootstrap 跑通 M0
  • M1+ engineering-packs 按需起草
  • 中优先级 ADR 在 M1+ 实施初期补齐

给生态内其他项目的启示

  • <本项目实战中得到的启示,对其他项目有借鉴价值的>

致谢与署名

  • 工作流维护者:<姓名 / 角色>
  • 主控 Agent:<例 Claude Code Sonnet 4.5>
  • 协作 Agent:<例 Codex via codex exec / 多个 sub-agent>
  • 上位文档:<战略白皮书 + 产品定义 引用>
  • 工程范式上位:ADR-001 / ADR-002 / ADR-003

本工作流的所有产出保留为 governance/workstreams/<workstream-id>/ 的完整资产,作为生态内后续项目的可复用参考。

END of 复盘