ADR Template
Type: ADRCreated: Team: Platform
published
Context
The situation, the problem, and the constraints. Be concrete: "We need X; today we do Y; the trade-off is Z."
Decision
What we decided, in 1–3 sentences. The decision itself, not the rationale.
Consequences
What becomes easier, what becomes harder, what we gave up. Be honest about the negatives.
Alternatives considered
One paragraph per option we rejected, and why. Often the most valuable section six months later.