# UX Scenarios

<!-- Managed with super-ux (ux-contract v4). Update in the same change as any user-facing behavior change. -->

## Index

| ID | Title | Feature | Persona | Traces | Status | Last audit |
|----|-------|---------|---------|--------|--------|------------|

## Personas

<!-- If docs/ux/foundation.md exists, this section is just a pointer to it.
Otherwise define personas here, 1-3 sentences each: who they are, what they
know, what they want. -->

## Scenarios

<!-- Group scenarios by feature under "## <feature>" headings. Entry shape
(see ux-contract v4 for field rules); steps are use-case style — one user
action per step paired with the observable system response:

### SCN-001: <Title>
- **Persona:** <persona-id>
- **Feature:** <feature>
- **Traces:** <ST-…, FLW-… (JTBD-…, JRN-…/#stage) — required when those layers exist>
- **Entry point:** <where the user starts>
- **Preconditions:** <state required, or "none">
- **Steps:**
  1. <user action> -> <observable system response>
- **Expected result:** <what the user observes on success>
- **Alt paths:** <meaningful non-error deviations and system responses, or omit>
- **UI elements:** <every button, field, link, dialog, toast involved>
- **States covered:** <loading | empty | error | success>
- **Errors & recovery:** <each failure: what the user sees, how they recover>
- **Telemetry:** <`object_action` event + params, or omit if none>
- **Status:** draft
- **Coverage:** none yet
- **Product:** unobserved
-->