# User Flows

<!--
AGENT INSTRUCTIONS:
- Reference when implementing user-facing features
- Ensure implementations follow expected user journeys
- Update as product evolves
-->

## Core Flows

### Flow 1: [Flow Name, e.g., "User Onboarding"]

**Trigger**: [What initiates this flow]
**Goal**: [What user accomplishes]
**Persona**: [Which persona - link to personas.md]

```
[Entry Point]
     │
     ▼
[Step 1: Action/Screen]
     │
     ├── [Happy path] ──▶ [Step 2]
     │                        │
     │                        ▼
     │                   [Step 3: Success]
     │
     └── [Error case] ──▶ [Error handling]
```

**Key Considerations**:
- [Important UX consideration]
- [Edge case to handle]

**Success Metrics**:
- [How we measure this flow works]

---

### Flow 2: [Flow Name]

**Trigger**: [What initiates this flow]
**Goal**: [What user accomplishes]
**Persona**: [Which persona]

```
[Entry Point]
     │
     ▼
[Steps...]
```

**Key Considerations**:
- [Important UX consideration]

---

## Secondary Flows

### [Flow Name]
[Brief description of less critical flows]

---

## Flow Patterns

### Error Handling
[Standard approach to errors across flows]

### Loading States
[Standard approach to loading states]

### Empty States
[Standard approach to empty states]

---

## Cross-References

| Flow | Related Specs | Related Features |
|------|---------------|------------------|
| [Flow] | LIN-XXX | [feature doc] |

---

*Last Updated: YYYY-MM-DD*