Why

1. To compare options and make an informed decision
2. To later share whenever there is a question from customers or leadership
3. To build on top of it, to create a roadmap

Why not

1. Meant for small / incremental decisions. Big projects probably need a full RFC.

What

• https://adr.github.io/madr/#overview

How

• https://adr.github.io/madr/examples.html

Template

Here are the sections I recommend:

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