Architecture Decision Records

Document significant architectural and technical decisions using the ADR format to preserve context, rationale, and consequences for future reference.

When to Use This Skill

• Making significant architectural decisions
• Choosing between technology options
• Establishing coding standards or patterns
• Documenting why something was built a certain way
• Onboarding new team members to understand past decisions
• Reviewing or reconsidering previous decisions

What is an ADR?

An Architecture Decision Record (ADR) is a document that captures an important architectural decision along with its context and consequences. ADRs help teams: