## Problem

<!-- The user-facing problem, not a pre-chosen solution. -->

## Who hits this

<!-- Which users or workflows run into it, and how often. -->

## Proposed direction

<!-- A sketch of one way to solve it — open to alternatives. Include an
     API sketch, CLI example, or mockup if it helps. -->

```text
# Example usage
```

## Alternatives considered

<!-- Other approaches and why they're less suitable. -->

-

## Out of scope

<!-- Adjacent things this issue deliberately does not cover. -->

## Additional Context

<!-- Links to similar features elsewhere, related discussions, etc. -->
