# Flows

<!--
Named user journeys. One per workflow from users.md. The mocks skill
generates one mock per flow. Steps here are conceptual — every screen
is captured in the corresponding mock, not duplicated here.
-->

## <flow-id> — <Short title>

- **Actor**: <user-class from users.md>
- **Trigger**: <what kicks this off>
- **Preconditions**: <state that must be true>
- **Steps**:
  1. <action / screen>
  2. <…>
  3. <…>
- **Success**: <observable outcome>
- **Failure modes**:
  - <named failure> → <how it's handled>
  - <…>

## <flow-id> — <Short title>

…