user-story-mapping

Installation
SKILL.md

User Story Mapping

User Story Mapping is a product planning technique developed by Jeff Patton and described in his 2014 O'Reilly book User Story Mapping: Discover the Whole Story, Build the Right Product. The technique arranges user activities and tasks in a two-dimensional grid — left to right as a narrative of user behavior, top to bottom by priority — so teams can identify the smallest release that delivers real value without losing sight of the whole story.

Core Principle

The problem with agile development is not stories — it is what teams do with them. Flattening work into a prioritized backlog strips stories of context. Patton describes the result as "A bag of context-free mulch": dozens of cards that cannot be navigated, communicated through, or used to find what is missing. (Patton, jpattonassociates.com/the-new-backlog/)

The solution is to organize stories spatially. A story map preserves the narrative of how users move through a system. Working left to right follows user sequence; working top to bottom reveals prioritization within each activity. The result is a planning artifact that teams can walk, slice, and update together.

The foundation: "Shared documents aren't shared understanding." The value of story mapping is not the map itself — it is the conversation the map enables and the common mental model the team builds while making it. (Patton, jpattonassociates.com/the-new-backlog/)

The User Story Mapping Framework

1. Story Map Anatomy

Core concept: A story map is a two-dimensional grid. The top row — the backbone — holds high-level user activities arranged in chronological or logical sequence. Below each activity hang tasks: the specific things users do to accomplish that activity. Below the tasks hang details: variations, edge cases, and alternatives. The backbone cannot be prioritized against itself (you cannot ship email without compose and inbox), but tasks and details can be sliced into releases. (Patton, jpattonassociates.com/the-new-backlog/; marcabraham.com/2012/07/27/)

Why it works: The grid format preserves narrative flow that a flat list destroys. Walking the top row tells you what the product does; walking down any column shows you how deep that capability needs to go. Teams can see both the whole story and where individual stories fit within it simultaneously.

Related skills

More from ivcota/skills

Installs
1
Repository
ivcota/skills
GitHub Stars
1
First Seen
Apr 20, 2026