# User Story Mapping

> Organize backlog by user journey when planning releases and identifying experience gaps

- Skill: `lev-os/user-story-mapping` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lev-os/user-story-mapping`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lev-os/user-story-mapping/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: lev-os (https://skillmd.com/u/lev-os)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/lev-os/user-story-mapping

---


## Core Principle

User Story Mapping is a **two-dimensional visualization technique** that arranges product backlog items along a user journey (horizontal axis) and by priority (vertical axis). Instead of a flat prioritized list that loses context, story maps show **how features fit together** to deliver complete user experiences.

Created by Jeff Patton in the early 2000s, story mapping addresses the fundamental weakness of traditional backlogs: they tell you what to build but not why, creating a disconnected list of tasks that loses sight of the user's end-to-end experience.

## When to Use

Deploy User Story Mapping when you need to:
- **Plan new products** or major features that involve multiple user workflows
- **Align stakeholders** on release scope and MVP definition
- **Identify gaps** in user experience that flat backlogs hide
- **Prioritize work** in context of complete user journeys, not isolated tasks
- **Onboard new team members** by showing how features connect to user goals

Particularly powerful during **release planning** and **MVP definition**, where understanding trade-offs between user value and scope is critical.

## How It Works

### Story Map Structure

**Horizontal Axis: User Journey (Left to Right)**
The backbone of activities users perform to accomplish their goals, organized sequentially.

```
[Login] → [Browse Products] → [Add to Cart] → [Checkout] → [Track Order]
```

**Vertical Axis: Priority (Top to Bottom)**
- **Top rows**: Essential activities and tasks (MVP, release 1)
- **Middle rows**: Important enhancements (release 2, 3)
- **Bottom rows**: Nice-to-haves and future ideas

**Walking Skeleton**: The top row of cards represents the minimum viable journey - the thinnest possible implementation that delivers end-to-end value.

### Building a Story Map: Step-by-Step

**Step 1: Frame the User Journey (Backbone)**

Identify high-level activities users perform to accomplish their goal.

- Start with user persona and primary goal
- Break goal into 5-10 major activities (verbs, not features)
- Arrange activities left-to-right in chronological order
- **Output**: Horizontal backbone of user activities

**Example** (E-commerce):
```
[Discover Products] → [Evaluate Options] → [Purchase] → [Receive & Use] → [Get Support]
```

**Step 2: Break Down into Tasks**

For each activity, identify specific tasks users perform.

- Write tasks on cards/sticky notes (user stories: "As a [user], I want to [action]")
- Place tasks vertically under relevant activity
- Don't prioritize yet - capture everything users might do
- **Output**: Full map of all possible user tasks

**Example** (under "Purchase"):
```
- As a buyer, I want to add items to cart
- As a buyer, I want to apply discount codes
- As a buyer, I want to save cart for later
- As a buyer, I want to choose shipping options
- As a buyer, I want to enter payment details
- As a buyer, I want to review order before confirming
```

**Step 3: Prioritize with Horizontal Slicing**

Draw horizontal lines to define releases.

- **Release 1 (Walking Skeleton)**: Minimum viable journey - simplest path through backbone
- **Release 2**: Enhancements that make experience better
- **Release 3+**: Nice-to-haves and optional features

Ask: "Can users accomplish their core goal without this?" If yes, move down.

**Example Slices**:
```
Release 1 (MVP):
  [Login] → [Browse by category] → [Add to cart] → [Credit card checkout] → [Email confirmation]

Release 2:
  + Search functionality
  + Guest checkout
  + Save payment methods
  + Order history

Release 3:
  + Wishlist
  + Gift wrapping
  + Social sharing
```

**Step 4: Identify Gaps and Assumptions**

Review the map for missing pieces.

- Walk through the journey as a user - does it make sense?
- Look for activities with too few tasks (under-specified)
- Check for tasks without supporting activities (orphaned features)
- Highlight risky assumptions requiring validation
- **Output**: Complete, coherent user experience with identified risks

**Step 5: Use for Planning and Communication**

The map becomes a living artifact for team alignment.

- **Sprint planning**: Pull cards from prioritized releases
- **Stakeholder communication**: Point to map to explain scope trade-offs
- **Progress tracking**: Move completed cards or mark with different colors
- **Onboarding**: New team members walk the map to understand product
- **Discovery**: Add new learnings and update priorities continuously

### Variations and Techniques

**Option 1: Multiple User Personas**
Use swim lanes for different user types (admin vs. customer vs. manager), each with their own journey.

**Option 2: Vertical Slicing by Capability**
Instead of horizontal releases, slice vertically by product capability (basic → standard → premium tiers).

**Option 3: Hybrid with Kano Model**
Color-code cards by Kano category (must-have = red, performance = yellow, delighter = green) to visualize satisfaction impact.

## Practical Examples

**Example 1: SaaS Onboarding Redesign**
Context: High drop-off during first 7 days, need to improve activation

- **Activity Backbone**: [Sign Up] → [Setup Account] → [Invite Team] → [Import Data] → [First Success]
- **Mapping Exercise**: Revealed 23 tasks in "Setup Account," overwhelming new users
- **Release 1 Decision**: Reduce to 3 essential tasks, defer 20 to progressive disclosure
- **Outcome**: Activation rate increased 35% by simplifying walking skeleton

**Example 2: Mobile Banking App MVP**
Context: Credit union expanding to mobile, limited budget for v1

- **Mapping**: Full retail banking journey from checking balance to loan applications
- **Key Insight**: 80% of user activity in first 3 activities (Balance, Transfer, Pay Bills)
- **MVP Slice**: Just those 3 core activities, defer investments, loans, and card management
- **Outcome**: Delivered in 4 months instead of 18, iterated based on usage data

**Example 3: Redesigning a Legacy System**
Context: Modernizing 15-year-old procurement software, unclear what's actually used

- **Mapping Workshop**: Product team + 5 power users mapped current journey
- **Discovery**: 60% of features in backlog never used, real pain points were manual workarounds
- **Reprioritization**: Scrapped 40 planned features, focused on automation of top 5 workflows
- **Outcome**: Faster delivery, higher adoption, better ROI

## Expected Outcomes

After creating a story map, you should have:
- **Shared understanding** of user journey across team and stakeholders
- **Clear MVP definition** based on thinnest viable experience, not feature list
- **Visible gaps** in user experience that flat backlogs hide
- **Contextual prioritization** - every task's purpose is clear
- **Flexible roadmap** - can easily adjust scope by moving horizontal slices

Success metric: Team can confidently answer "Why are we building this?" by pointing to the map.

## Common Pitfalls

**Building Feature Maps Instead of User Maps**: If your backbone is "Admin Panel → Reporting → Integrations," you've mapped system architecture, not user goals. Restart with user verbs.

**Too Much Detail Too Soon**: Don't write acceptance criteria during mapping. Keep cards high-level (story title only) to maintain overview.

**Treating It as One-Time Exercise**: Story maps are living documents. Update as you learn, don't let them get stale.

**Mapping in a Silo**: Build maps collaboratively with cross-functional team (PM, design, engineering). Solo mapping misses critical perspectives.

**Confusing Sequence with Priority**: Horizontal axis is temporal order (what users do first/next), vertical axis is importance (what ships when).

## Complementary Practices

Combine User Story Mapping with:
- **Jobs to Be Done** to define the goals driving each activity in the backbone
- **Opportunity Solution Trees** to connect map to underlying customer problems
- **Kano Model** to categorize tasks by satisfaction impact (must-have vs. delighter)
- **RICE Prioritization** for ranking tasks within each release slice
- **Continuous Discovery Habits** to validate assumptions highlighted in the map

---

**Concept Origin**: Jeff Patton (early 2000s)
**Key Resources**:
- User Story Mapping: Discover the Whole Story, Build the Right Product (Patton, 2014)
- The New User Story Backlog is a Map (jpattonassociates.com)
- StoriesOnBoard (digital story mapping tool)