Decision records
When I make an architecture decision, I write it down so teams can see the reasoning.
Every record I write follows this outline. I research the options and design the solution by working through its questions.
Architecture decision record
- ContextWhy does this need a decision now, and what’s true today?
- DecisionWhat are we going to do?
- AssumptionsWhich things are we taking as true without proof?
- Options consideredHow else could we solve it?
- TradeoffsWhat does each option cost, and what does it give us?
- ConsequencesOnce it’s in place, what changes, good and bad?
- Implementation notesHow does it get built and rolled out?
- Open questionsWhat don’t we know yet?
- ReferencesWhere did the research come from?