architecture-decision

name	architecture-decision
description	形成可追溯的技术与集成决策记录。用于选择技术栈、定义接口或数据边界、评估第三方依赖、确定存储与运行方式，或在多个实现方案之间需要明确取舍及验证依据时。

架构决策记录

将影响后续实现和运维的关键决定记录为可复核依据。

流程

1. 明确需要决策的问题、驱动因素、硬约束、非目标和受影响角色。
2. 检查仓库既有模式与已采用能力，避免无必要地新增技术或外部依赖。
3. 比较可行方案的复杂度、可靠性、安全性、成本、可测试性和运维影响。
4. 对涉及凭据、外部写入、支付或生产的方案调用 $security-risk-review；涉及新接入时调用 $integration-onboarding。
5. 记录选择、理由、被放弃方案、接口或数据流影响、验证方式和重新评估触发条件。

输出

• 决策主题与状态
• 背景和约束
• 选择及理由
• 接口、数据流或依赖影响
• 风险、验证与回退策略

停止条件

若影响决定的产品边界或安全授权尚未确认，记录为待决定事项，不替用户选择高风险方案。