Architecture Decision

---
title: Architecture Decision Record
category: development
tags: [architecture, adr, design-decisions, trade-offs, documentation]
difficulty: advanced
models: [claude, gpt-4, gemini]
---

# Architecture Decision Record (ADR)

Generate structured Architecture Decision Records that document why specific
technical decisions were made, what alternatives were considered, and what
trade-offs were accepted.

## When to Use

- Choosing between competing technologies or approaches
- Making irreversible or hard-to-reverse technical decisions
- Documenting existing architectural decisions retroactively
- Justifying technical choices for stakeholders
- Onboarding new team members who need to understand past decisions

## The Technique

ADRs follow a standardized format that captures not just the decision,
but the context, constraints, and trade-offs that led to it.

## Template