# User Story Mapping Workshop

Run a user story mapping workshop with adaptive questions and a structured map output.

- Repository: https://github.com/deanpeters/Product-Manager-Skills (7825 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-16
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -g -a claude-code -y`
Codex: `npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -g -a codex -y`
Cursor: `npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -g -a cursor -y`
Gemini CLI: `npx skills add deanpeters/Product-Manager-Skills --skill user-story-mapping-workshop -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add deanpeters/Product-Manager-Skills`

## Description

Run a user story mapping workshop with adaptive questions and a structured map output. Use when you need backbone activities, tasks, and release slices for a workflow.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Purpose
Guide product managers through creating a user story map by asking adaptive questions about the system, users, workflow, and priorities, then generating a two-dimensional map with backbone (activities), user tasks, and release slices. Use this to move from flat backlogs to visual story maps that communicate the big picture, identify missing functionality, and enable meaningful release planning, avoiding "context-free mulch" where stories lose connection to the overall system narrative.

This is not a backlog generator, it's a visual communication framework that organizes work by user workflow (horizontal) and priority (vertical).

## Input

**Works best with:** The system or workflow to map.
**Also useful:** The primary users, workflow steps you already know, and what the map must decide (MVP scope, release plan).

Anything supplied with the invocation itself, text after the skill name, a pasted context dump, or an appended `ARGUMENTS:` line, counts as answers already given. Use it and skip whatever it covers; don't re-ask.

**Arriving empty-handed? That works too.** The workshop opens by asking about the system and its users (Q1), then proceeds per the facilitation protocol.

**Example invocation:** `Run a story mapping workshop for our vendor onboarding portal, output should give us a first release slice.`

## Key Concepts

### What is a User Story Map?

A story map (Jeff Patton) organizes user stories in **two dimensions**:

**Horizontal axis (left to right):** Activities arranged in narrative/workflow order, the sequence you'd use explaining the system to someone

**Vertical axis (top to bottom):** Priority within each activity, with the most essential tasks at the top

**Structure:**
```
Backbone (Activities across top)
↓
User Tasks (descending vertically by priority)
↓
Details/Acceptance Criteria (at the bottom)
```

### Key Principles

The rest: https://github.com/deanpeters/Product-Manager-Skills/blob/HEAD/skills/user-story-mapping-workshop/SKILL.md