软件工程
规划软件架构决策
一个有记录的架构决策:依据明确限制比较方案、记录后果,并在实施前指定验证检查点。
流程
按这个顺序做。
- 说明决策、背景、受影响用户、具有架构意义的要求、时间范围,以及谁可以批准这项选择。
- 收集产品、仓库、可靠性、安全、成本与合规的相关限制,并将已核实事实与假设和未知事项分开。
- 至少定义两个可行方案以及不采取行动,并用明确标准比较,而不是凭熟悉程度选择。
- 对每个方案进行压力测试,检验故障模式、迁移工作量、运营负担、可逆性、安全暴露和长期变更成本。
- 选择建议或明确记录推迟决策,并附理由、异议、被拒方案以及会改变决策的条件。
- 在实施开始前,写入包含状态、背景、决策、后果、证据链接、负责人和复核触发条件的决策记录。
- 与负责人复核记录,记录批准或必要条件,并把产物、证据和未解决风险交回请求者。
先准备
猫会向你要的输入。
- 架构决策与决策负责人
- 要求与限制
- 当前系统与修订
- 可用证据与复核相关方
路由器 + 一份 playbook
先路由。只选一份。
Cat Paw 每次任务只加载一份 playbook,不合并多份。先走这个路由器;其余路径是此 workflow 可检查的候选。
- 路由器:
software-delivery-pack skills/software-delivery-pack/software-architecture-decision-gate/SKILL.md
界限
界限跟着提示一起走。
- 开始前核实实际工具、账号、权限和工作区;绝不声称拥有不可用的工具、账号、来源或能力。
- 私有代码、产物、实时探测或非公开数据使用 Latch/target-workspace;如果无法访问,就在边界停止并报告阻塞,不要用猜测替代。
- 任何有后果的外部行动前先暂停并取得明确批准;返回证据、未解决风险、假设以及仍等待批准的行动。
完成代表
一个可核对的终点。
已批准或明确推迟的架构决策记录包含背景、方案、理由、后果、负责人、证据和复核触发条件。
来源
这个流程从哪来。
来源确立 workflow 的模式。如有 Reddit 或社区帖子,视为实务轶事,不是普遍事实。