Design

Context

<!-- Current state and constraints that shape the approach. See proposal.md for motivation - don't restate it -->

Goals / Non-Goals

Goals:

<!-- What this design aims to achieve -->

Non-Goals:

<!-- What is explicitly out of scope -->

Decisions

<!-- Key design decisions with rationale and alternatives considered -->

Risks / Trade-offs

<!-- Known risks and trade-offs -->