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)