Journey Mapping
Purpose
Map complete user journeys with entry points, states, emotions, and decision points to ensure features serve real user needs.
Scope Constraints
Reads feature descriptions, user stories, and existing screen documentation for journey analysis. Does not modify files or execute code. Does not access user analytics data or production systems directly.
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)
Input Sanitization
No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.
Procedure
Progress Checklist
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)
Compaction resilience: If context was lost during a long session, re-read the Inputs section to reconstruct what feature is being mapped, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.
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]
Handoff
- Hand off to interaction-design if component-level interaction specs are needed for UI elements identified in the journey.
- Hand off to craftsman/pattern-analysis if implementation patterns are needed for the mapped user flows.
Quality Checks
Evolution Notes
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: journey-mapping3description: Use when mapping complete user journeys through multi-step flows, onboarding sequences, or feature workflows. Covers entry points, happy paths, alternate paths, error states, friction analysis, and delight opportunities. Do not use for individual component interaction specs (use interaction-design).4---56# Journey Mapping78## Purpose910Map complete user journeys with entry points, states, emotions, and decision points to ensure features serve real user needs.1112## Scope Constraints1314Reads feature descriptions, user stories, and existing screen documentation for journey analysis. Does not modify files or execute code. Does not access user analytics data or production systems directly.1516## Inputs1718- Feature description or user story19- Target user persona (or enough context to infer one)20- Existing screens/views if modifying an existing flow21- Any known constraints (platform, auth requirements, data dependencies)2223## Input Sanitization2425No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.2627## Procedure2829### Progress Checklist30- [ ] Step 1: Identify the user persona31- [ ] Step 2: Define entry points32- [ ] Step 3: Map the happy path33- [ ] Step 4: Map alternate paths34- [ ] Step 5: Map error and edge paths35- [ ] Step 6: Identify friction points36- [ ] Step 7: Design delight moments3738### Step 1: Identify the User Persona3940- Who is this for?41- What is their context (new user, power user, admin)?42- What job are they hiring this feature to do?43- What is their emotional state when they arrive (frustrated, curious, task-focused)?4445### Step 2: Define Entry Points4647How does the user discover or arrive at this feature:48- Direct navigation (sidebar, menu)49- Deep link / URL50- Notification or alert51- Search result52- Redirect from another flow53- First-time onboarding prompt5455### Step 3: Map the Happy Path5657Walk through step by step:5859| Step | Screen/View | User Action | System Response | User Emotion | Notes |60|------|-------------|-------------|-----------------|--------------|-------|61| 1 | ... | ... | ... | ... | ... |6263For each step capture:64- What does the user see?65- What action do they take?66- What feedback do they receive?67- What emotion do they feel? (confident, confused, delighted, anxious, neutral)6869### Step 4: Map Alternate Paths7071- **First-time user vs returning user** — different onboarding needs, remembered preferences72- **Power user shortcuts** — keyboard shortcuts, bulk actions, saved presets73- **Mobile vs desktop** — layout differences, touch vs pointer, reduced screen real estate7475### Step 5: Map Error and Edge Paths7677- What happens when something fails (API error, validation failure)?78- Empty states (no data yet) — what does the user see and do?79- Permission denied — clear messaging and recovery path80- Network failure mid-flow — data preservation, retry strategy81- Timeout or slow response — loading states, skeleton screens8283### Step 6: Identify Friction Points8485Where users might:86- Hesitate (unclear next action)87- Get confused (ambiguous UI, unexpected behavior)88- Abandon (too many steps, too much required input)89- Make errors (easy to misclick, unclear consequences)9091### Step 7: Design Delight Moments9293Where can we exceed expectations:94- Instant feedback (optimistic updates, real-time validation)95- Smart defaults (pre-filled from context, remembered preferences)96- Progressive disclosure (show basics first, reveal complexity on demand)97- Micro-interactions (subtle animations that confirm actions)98- Shortcuts (auto-complete, recent items, suggested actions)99100> **Compaction resilience**: If context was lost during a long session, re-read the Inputs section to reconstruct what feature is being mapped, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.101102## Output Format103104### Journey Map Table105106| Step | Screen/View | User Action | System Response | User Emotion | Notes |107|------|-------------|-------------|-----------------|--------------|-------|108| ... | ... | ... | ... | ... | ... |109110### Entry Point Diagram111112```113[Entry Point A] ──→ [Step 1] ──→ [Step 2] ──→ ...114[Entry Point B] ──→ [Step 1]115 ↓116 [Error Path] ──→ [Recovery]117```118119### Friction and Delight Annotations120121- **Friction:** [Step X] — [description of friction and mitigation]122- **Delight:** [Step Y] — [description of delight opportunity]123124## Handoff125126- Hand off to interaction-design if component-level interaction specs are needed for UI elements identified in the journey.127- Hand off to craftsman/pattern-analysis if implementation patterns are needed for the mapped user flows.128129## Quality Checks130131- [ ] Every step has an emotion annotation132- [ ] Error paths are mapped for each step that can fail133- [ ] Empty states are designed (not just "no data")134- [ ] Mobile path is considered135- [ ] Entry points cover all discovery methods136- [ ] First-time vs returning user differences noted137- [ ] Friction points have mitigation strategies138- [ ] At least one delight moment identified139140## Evolution Notes141<!-- Observations appended after each use -->142143---144> Converted and distributed by [TomeVault](https://tomevault.io/claim/dtsong) — claim your Tome and manage your conversions.145<!-- tomevault:4.0:skill_md:2026-04-13 -->