One paragraph: what is being proposed?
What problem does this solve? Who is affected?
API changes, data formats, CLI flags, migration steps.
What else was evaluated and why it was not chosen?
Threats, trust boundaries, supply-chain or privacy impact.
Phases, feature flags, deprecation timeline.
Links to issues, prior art, and related docs (docs/, ADRs if any).
Optional diagrams, examples, or extended rationale.