ADR template

Copy this into docs/adr/NNNN-short-title.md and fill it in; the playbook has the steps.

# NNNN. Title in the imperative ("Use X for Y")

- **Status:** Proposed | Accepted | Superseded by [NNNN](NNNN-title.md) | Deprecated
- **Date:** YYYY-MM-DD
- **Deciders:** names

## Context

What forces are at play? Include constraints, requirements, and what we know and don't know.
Link to the docs and code that matter.

## Decision

What we will do, stated plainly.

## Consequences

What becomes easier, what becomes harder, what we now have to do, and what would make us revisit this.

## Alternatives considered

- **Option:** why not