Skip to content

ADR NNN: [Short descriptive title]

Status

Proposed | Accepted | Deprecated | Superseded by ADR XXX

Context

What is the problem, situation, or question that prompted this decision?

Include relevant constraints, forces, and background. If there are related ADRs, link them here.

Decision

What is the change or choice that we're making?

Be specific. If there's a configuration or code pattern, show a brief example.

Alternatives Considered

[Alternative 1 name]

Brief description of the approach.

Rejected because: One or two sentences explaining why this wasn't chosen.

[Alternative 2 name]

Brief description of the approach.

Rejected because: One or two sentences explaining why this wasn't chosen.

Consequences

Positive

  • What becomes easier or better?
  • What problems does this solve?

Negative

  • What becomes harder or worse?
  • What new problems does this introduce?
  • What maintenance burden does this add?

Neutral

  • What is unchanged?
  • What is a wash (equal positives and negatives)?

Mitigations

  • How are the negative consequences addressed?

Implementation

References