# PR Description Template

The PR description is the durable home for everything that is not a rule:
rationale, scope decisions, rejected alternatives. Copy, fill, delete unused
sections.

```markdown
## Why

<The problem, one paragraph. Link the discussion if there was one.>

## What changed

<Behavior first, implementation second. Bullets.>

## Decisions and alternatives

<Choices made and what was rejected, with the reason. This is the section
future readers will thank you for — it never goes in the docs tree.>

## Out of scope

<What this PR deliberately does not do.>

## Docs evidence

<Exactly one of:>
Docs updated first: <list of changed docs>
Docs checked, no change needed: <docs + reason>
Docs not applicable: <why implementation-only>

## Verification

<Commands run and their results. Screenshots for visual work.>
```