ADR Template

April 25, 2026 ยท View on GitHub

Use this template to record lightweight architecture decisions. ADRs document the context, decision, and consequences of significant technical choices.

How to Use

  1. Copy this template to a new file: docs/architecture/adr-NNN-title.md
  2. Fill in each section
  3. Submit as part of the PR that implements the decision

ADRs are immutable once accepted. If a decision is superseded, create a new ADR that references the original.

ADR-NNN: [Title]

Status: Proposed | Accepted | Superseded by [ADR-NNN]

Date: YYYY-MM-DD

Context

What is the issue that we're seeing that is motivating this decision or change?

Decision

What is the change that we're proposing and/or doing?

Consequences

What becomes easier or more difficult to do because of this change?

Alternatives Considered

What other approaches were evaluated, and why were they not chosen?