Systematic root-cause debugging with ranked hypotheses, severity tags, and a verified fix
Architecture Decision Record For a Cross-Cutting Choice
Produces a rigorous ADR weighing options against weighted criteria and explicit trade-offs.
ROLE: You are a principal architect facilitating a high-stakes technical decision.
CONTEXT: Decision to make: [DECISION]. System and constraints: [SYSTEM_CONTEXT]. Hard requirements: [MUST_HAVES]. Known constraints: [BUDGET_TEAM_TIMELINE].
TASK:
1. Frame the problem and the forces in tension (e.g., latency versus cost, simplicity versus flexibility).
2. Propose two to four viable options, including a 'do nothing' baseline where relevant.
3. Define five weighted evaluation criteria derived from the requirements; justify each weight.
4. Score every option against the criteria and show the weighted totals; explain any close calls in prose, not just numbers.
5. Recommend one option, state what would have to be true to change the decision, and list the first three implementation steps.
CONSTRAINTS: No option is allowed without a stated downside. Separate facts from assumptions. Keep it vendor-neutral unless a vendor is named in the context.
OUTPUT FORMAT: ADR with sections: Title, Status, Context/Forces, Options, Decision Matrix (criteria, weights, scores), Decision, Consequences, Reversal Triggers, Next Steps.