Journey Mapping
Purpose
Map complete user journeys with entry points, states, emotions, and decision points to ensure features serve real user needs.
Inputs
- Feature description or user story
- Target user persona (or enough context to infer one)
- Existing screens/views if modifying an existing flow
- Any known constraints (platform, auth requirements, data dependencies)
Process
Step 1: Identify the User Persona
- Who is this for?
- What is their context (new user, power user, admin)?
- What job are they hiring this feature to do?
- What is their emotional state when they arrive (frustrated, curious, task-focused)?
Step 2: Define Entry Points
How does the user discover or arrive at this feature:
- Direct navigation (sidebar, menu)
- Deep link / URL
- Notification or alert
- Search result
- Redirect from another flow
- First-time onboarding prompt
Step 3: Map the Happy Path
Walk through step by step:
| Step |
Screen/View |
User Action |
System Response |
User Emotion |
Notes |
| 1 |
... |
... |
... |
... |
... |
For each step capture:
- What does the user see?
- What action do they take?
- What feedback do they receive?
- What emotion do they feel? (confident, confused, delighted, anxious, neutral)
Step 4: Map Alternate Paths
- First-time user vs returning user — different onboarding needs, remembered preferences
- Power user shortcuts — keyboard shortcuts, bulk actions, saved presets
- Mobile vs desktop — layout differences, touch vs pointer, reduced screen real estate
Step 5: Map Error and Edge Paths
- What happens when something fails (API error, validation failure)?
- Empty states (no data yet) — what does the user see and do?
- Permission denied — clear messaging and recovery path
- Network failure mid-flow — data preservation, retry strategy
- Timeout or slow response — loading states, skeleton screens
Step 6: Identify Friction Points
Where users might:
- Hesitate (unclear next action)
- Get confused (ambiguous UI, unexpected behavior)
- Abandon (too many steps, too much required input)
- Make errors (easy to misclick, unclear consequences)
Step 7: Design Delight Moments
Where can we exceed expectations:
- Instant feedback (optimistic updates, real-time validation)
- Smart defaults (pre-filled from context, remembered preferences)
- Progressive disclosure (show basics first, reveal complexity on demand)
- Micro-interactions (subtle animations that confirm actions)
- Shortcuts (auto-complete, recent items, suggested actions)
Output Format
Journey Map Table
| Step |
Screen/View |
User Action |
System Response |
User Emotion |
Notes |
| ... |
... |
... |
... |
... |
... |
Entry Point Diagram
[Entry Point A] ──→ [Step 1] ──→ [Step 2] ──→ ...
[Entry Point B] ──→ [Step 1]
↓
[Error Path] ──→ [Recovery]
Friction and Delight Annotations
- Friction: [Step X] — [description of friction and mitigation]
- Delight: [Step Y] — [description of delight opportunity]
Quality Checks
Evolution Notes
1---2name: journey-mapping3description: Map complete user journeys with entry points, states, emotions, and decision points4---56# Journey Mapping78## Purpose910Map complete user journeys with entry points, states, emotions, and decision points to ensure features serve real user needs.1112## Inputs1314- Feature description or user story15- Target user persona (or enough context to infer one)16- Existing screens/views if modifying an existing flow17- Any known constraints (platform, auth requirements, data dependencies)1819## Process2021### Step 1: Identify the User Persona2223- Who is this for?24- What is their context (new user, power user, admin)?25- What job are they hiring this feature to do?26- What is their emotional state when they arrive (frustrated, curious, task-focused)?2728### Step 2: Define Entry Points2930How does the user discover or arrive at this feature:31- Direct navigation (sidebar, menu)32- Deep link / URL33- Notification or alert34- Search result35- Redirect from another flow36- First-time onboarding prompt3738### Step 3: Map the Happy Path3940Walk through step by step:4142| Step | Screen/View | User Action | System Response | User Emotion | Notes |43|------|-------------|-------------|-----------------|--------------|-------|44| 1 | ... | ... | ... | ... | ... |4546For each step capture:47- What does the user see?48- What action do they take?49- What feedback do they receive?50- What emotion do they feel? (confident, confused, delighted, anxious, neutral)5152### Step 4: Map Alternate Paths5354- **First-time user vs returning user** — different onboarding needs, remembered preferences55- **Power user shortcuts** — keyboard shortcuts, bulk actions, saved presets56- **Mobile vs desktop** — layout differences, touch vs pointer, reduced screen real estate5758### Step 5: Map Error and Edge Paths5960- What happens when something fails (API error, validation failure)?61- Empty states (no data yet) — what does the user see and do?62- Permission denied — clear messaging and recovery path63- Network failure mid-flow — data preservation, retry strategy64- Timeout or slow response — loading states, skeleton screens6566### Step 6: Identify Friction Points6768Where users might:69- Hesitate (unclear next action)70- Get confused (ambiguous UI, unexpected behavior)71- Abandon (too many steps, too much required input)72- Make errors (easy to misclick, unclear consequences)7374### Step 7: Design Delight Moments7576Where can we exceed expectations:77- Instant feedback (optimistic updates, real-time validation)78- Smart defaults (pre-filled from context, remembered preferences)79- Progressive disclosure (show basics first, reveal complexity on demand)80- Micro-interactions (subtle animations that confirm actions)81- Shortcuts (auto-complete, recent items, suggested actions)8283## Output Format8485### Journey Map Table8687| Step | Screen/View | User Action | System Response | User Emotion | Notes |88|------|-------------|-------------|-----------------|--------------|-------|89| ... | ... | ... | ... | ... | ... |9091### Entry Point Diagram9293```94[Entry Point A] ──→ [Step 1] ──→ [Step 2] ──→ ...95[Entry Point B] ──→ [Step 1]96 ↓97 [Error Path] ──→ [Recovery]98```99100### Friction and Delight Annotations101102- **Friction:** [Step X] — [description of friction and mitigation]103- **Delight:** [Step Y] — [description of delight opportunity]104105## Quality Checks106107- [ ] Every step has an emotion annotation108- [ ] Error paths are mapped for each step that can fail109- [ ] Empty states are designed (not just "no data")110- [ ] Mobile path is considered111- [ ] Entry points cover all discovery methods112- [ ] First-time vs returning user differences noted113- [ ] Friction points have mitigation strategies114- [ ] At least one delight moment identified115116## Evolution Notes117<!-- Observations appended after each use -->