ADR-0000: ADR Template

Status:

Template

Date:

N/A

Context

Describe the issue that motivates this decision. What problem are we trying to solve? What constraints exist? What forces are at play?

Include relevant background information that helps readers understand why this decision was necessary.

Decision

Describe what we have decided to do. Be specific about the chosen approach.

Use bullet points or code examples where helpful:

# Example code showing the decision
class Example:
    pass

Consequences

Describe the resulting context after applying the decision. Include both positive and negative consequences:

Positive:

  • List benefits of this approach

Negative:

  • List trade-offs or downsides

Neutral:

  • List other implications

References

  • Link to relevant PRs, issues, or external resources

  • Related ADRs: ADR-NNNN-related-decision (use :doc: directive)