Context
What decision do we need to make? What constraints matter?
Options
Which options did we consider, and what evidence supports each?
Decision
What have we chosen, and why?
Consequences
What tradeoffs and follow-up work does this choice create?
Evidence
Record each claim, source, date checked and remaining uncertainty.
Revisit
What would make us reconsider this decision?
TAKE THE STRUCTURE WITH YOU
# An architecture decision record with evidence. ## Context What decision do we need to make? What constraints matter? ## Options Which options did we consider, and what evidence supports each? ## Decision What have we chosen, and why? ## Consequences What tradeoffs and follow-up work does this choice create? ## Evidence Record each claim, source, date checked and remaining uncertainty. ## Revisit What would make us reconsider this decision?