When should I write an Architecture Decision Record?

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 […]