<项目名> 架构重构复盘
工作流收尾时由维护者填写。本复盘的双重目的:
- 沉淀本项目的工作流细节作历史可追溯
- 反馈给
commons/playbooks/architecture-document-rewrite.md,识别方法论改进点
第一部分:量化产出
| 类别 | 产出 |
|---|---|
| 主架构文档 | <行数> 行 / <部分数> 部分 / <章节数> 节 / <Mermaid 图数> 张 |
| Engineering pack(如已拆分) | m{N}-*.md × N 份,合计 <行数> 行 |
| 架构决策(ADR) | <已 accepted N>,<待写 N> |
| 多 Agent Review | R1 |
| 上位文档对齐 | <战略白皮书 / 产品定义 修订项数量> |
| 同位文档归档 | <被新架构吸收并归档的 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 复盘