Writing Architecture Decision Records

What is an ADR?

An Architecture Decision Record captures an important architectural decision along with its context and consequences.

When to Write an ADR

• Choosing a framework or library
• Selecting a database or storage solution
• Defining API patterns
• Establishing coding conventions
• Making infrastructure decisions
• Any decision that affects multiple components

ADR Structure

Title

Short phrase describing the decision.