TL;DR Have you made a significant decision that impacts how engineers write software? Write an ADR! An Architecture Decision Record (ADR) is a document that captures a decision, including the context of how the decision was made and the consequences of adopting the decision. At Spotify, a handful of teams use ADRs to document their decisions. One of these teams, The Creator Team, focuses on provi
![When Should I Write an Architecture Decision Record - Spotify Engineering](https://cdn-ak-scissors.b.st-hatena.com/image/square/195f5993a9b62f246406db8b9d30165cff56a3de/height=288;version=1;width=512/https%3A%2F%2Fstorage.googleapis.com%2Fproduction-eng%2F1%2F2020%2F04%2FWhen-should-I-write-an-Architecture-Decision-Record-01.png)