Context

The problem, the forces at play, and the constraints that made a decision necessary. What changed, and why now? |^|

Decision

What we decided, stated plainly in one or two sentences.

Consequences

Positive

• What we gain.

Negative / trade-offs

• What we accept in return.

Alternatives considered

The other options weighed, and why each was not chosen.

References

• Real links out: GitHub PRs/commits/issues and external sources. (Links to other ADRs go in the dependsOn / related frontmatter.)