Skip to main content

ADR Template

Format

All Architecture Decision Records follow this structure:

# ADR-NNN: Title

**Status:** Proposed | Accepted | Deprecated | Superseded
**Date:** YYYY-MM-DD
**Context:** Brief description of the problem or decision

## Decision

What was decided and why.

## Consequences

- Positive outcomes
- Trade-offs
- Risks

## Alternatives Considered

- Alternative 1: Why not chosen
- Alternative 2: Why not chosen

## Related Documents

- Links to related ADRs, specs, or docs

Naming Convention

  • Files: adr/NNN-slug.md (e.g., adr/001-cloud-provider-oci.md)
  • Sequential numbering
  • Lowercase slug with hyphens