Architectural Decision Records

Why

  1. To make a thorough decision, esp. exploring alternatives
  2. To share whenever there is a question from customers or leadership
  3. To roadmap on top of earlier decisions

What

How

Template

Here are the sections I recommend:

  1. Context
  2. Problem Statement
  3. Solution Options
  4. Options Evaluation
  5. Conclusion
  6. Notes

Subscribe to Swaroop CH

Sign up now to get access to the library of members-only issues.
Jamie Larson
Subscribe