ADR-XXX: Decision title
Status
Accepted / Proposed / Deprecated
Context
Why the decision was necessary. Cite the code or the incident. If you only have a hypothesis, stop and do not file the ADR.
Decision
What was decided, in the form the code enforces.
Alternatives
What alternatives were considered. If the repository does not record them, write: not recorded.
Consequences
What developers must do, and what fails if they do not.
Related code
Links to implementation, using pnxt-api: paths so the repository URL stays configurable.