{{ADR NUMBER}}. {{TITLE}}

• Status: {proposed | accepted | deprecated | superseded by ADR-XXXX}
• Date: YYYY-MM-DD
• Deciders: {one or more authors}
• Tags: {architecture | infra | testing | …}

Context

What problem are we solving? What forces are at play?

Decision

What we decided. Short and unambiguous.

Consequences

What becomes easier / harder. Trade-offs we accept.

Alternatives considered

Each alternative gets a paragraph: what it was, why we rejected it.

References

• Links to plan files, issues, spec sections, upstream docs.