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-mapping3department: "advocate"4description: "Map complete user journeys with entry points, states, emotions, and decision points"5version: 16triggers:7 - "user flow"8 - "journey"9 - "onboarding"10 - "experience"11 - "workflow"12 - "entry point"13 - "happy path"14 - "user story"15 - "persona"16---1718# Journey Mapping1920## Purpose2122Map complete user journeys with entry points, states, emotions, and decision points to ensure features serve real user needs.2324## Inputs2526- Feature description or user story27- Target user persona (or enough context to infer one)28- Existing screens/views if modifying an existing flow29- Any known constraints (platform, auth requirements, data dependencies)3031## Process3233### Step 1: Identify the User Persona3435- Who is this for?36- What is their context (new user, power user, admin)?37- What job are they hiring this feature to do?38- What is their emotional state when they arrive (frustrated, curious, task-focused)?3940### Step 2: Define Entry Points4142How does the user discover or arrive at this feature:43- Direct navigation (sidebar, menu)44- Deep link / URL45- Notification or alert46- Search result47- Redirect from another flow48- First-time onboarding prompt4950### Step 3: Map the Happy Path5152Walk through step by step:5354| Step | Screen/View | User Action | System Response | User Emotion | Notes |55|------|-------------|-------------|-----------------|--------------|-------|56| 1 | ... | ... | ... | ... | ... |5758For each step capture:59- What does the user see?60- What action do they take?61- What feedback do they receive?62- What emotion do they feel? (confident, confused, delighted, anxious, neutral)6364### Step 4: Map Alternate Paths6566- **First-time user vs returning user** — different onboarding needs, remembered preferences67- **Power user shortcuts** — keyboard shortcuts, bulk actions, saved presets68- **Mobile vs desktop** — layout differences, touch vs pointer, reduced screen real estate6970### Step 5: Map Error and Edge Paths7172- What happens when something fails (API error, validation failure)?73- Empty states (no data yet) — what does the user see and do?74- Permission denied — clear messaging and recovery path75- Network failure mid-flow — data preservation, retry strategy76- Timeout or slow response — loading states, skeleton screens7778### Step 6: Identify Friction Points7980Where users might:81- Hesitate (unclear next action)82- Get confused (ambiguous UI, unexpected behavior)83- Abandon (too many steps, too much required input)84- Make errors (easy to misclick, unclear consequences)8586### Step 7: Design Delight Moments8788Where can we exceed expectations:89- Instant feedback (optimistic updates, real-time validation)90- Smart defaults (pre-filled from context, remembered preferences)91- Progressive disclosure (show basics first, reveal complexity on demand)92- Micro-interactions (subtle animations that confirm actions)93- Shortcuts (auto-complete, recent items, suggested actions)9495## Output Format9697### Journey Map Table9899| Step | Screen/View | User Action | System Response | User Emotion | Notes |100|------|-------------|-------------|-----------------|--------------|-------|101| ... | ... | ... | ... | ... | ... |102103### Entry Point Diagram104105```106[Entry Point A] ──→ [Step 1] ──→ [Step 2] ──→ ...107[Entry Point B] ──→ [Step 1]108 ↓109 [Error Path] ──→ [Recovery]110```111112### Friction and Delight Annotations113114- **Friction:** [Step X] — [description of friction and mitigation]115- **Delight:** [Step Y] — [description of delight opportunity]116117## Quality Checks118119- [ ] Every step has an emotion annotation120- [ ] Error paths are mapped for each step that can fail121- [ ] Empty states are designed (not just "no data")122- [ ] Mobile path is considered123- [ ] Entry points cover all discovery methods124- [ ] First-time vs returning user differences noted125- [ ] Friction points have mitigation strategies126- [ ] At least one delight moment identified127128## Evolution Notes129<!-- Observations appended after each use -->