
User Story Mapping
Structure personas, backbone activities, and step-level user stories so you can prioritize a v1 slice before building.
Overview
User Story Mapping is an agent skill most often used in Validate (also Idea, Build) that structures personas, backbone activities, and steps into a prioritizable story map.
Install
npx skills add https://github.com/deanpeters/product-manager-skills --skill user-story-mappingWhat is this skill?
- Documents Who with segment and persona narratives for a target user
- Defines a Backbone narrative plus ordered high-level Activities
- Breaks each activity into Steps suitable for user stories and acceptance criteria
- Includes a worked freelance-invoicing example map in the skill readme
- Supports prioritizing walking-skeleton releases instead of flat backlog dumps
- Example map covers 5 backbone activities from negotiation through late-payment follow-up
Adoption & trust: 1.4k installs on skills.sh; 5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You know the problem domain but cannot see the full user journey or which stories belong in the first release.
Who is it for?
Solo founders scoping SaaS or workflow products who need a visual journey before writing specs or code.
Skip if: Pure engineering refactors with no user journey change, or teams that already have a signed PRD and locked sprint backlog.
When should I use this skill?
When scoping a product, defining MVP from a user journey, or when the user asks for user story mapping, backbone activities, or release slicing.
What do I get? / Deliverables
You produce a narrative-backed story map with persona, backbone, activities, and steps you can slice into an MVP backlog and implementation plans.
- Markdown user story map with Who, Backbone, Activities, and Steps
- Prioritized release slice candidates from the map
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Story mapping is the canonical validate activity for turning fuzzy ideas into a scoped narrative and backlog. Scope subphase covers journey decomposition and release slicing—the core output of a user story map.
Where it fits
Turn interview notes about freelance admin pain into a persona-led map.
Define backbone activities for invoicing and pick the first horizontal release.
Translate step-level stories into tickets before frontend implementation.
How it compares
Use instead of dumping unstructured feature lists in chat—this skill enforces persona, backbone, and activity-step hierarchy.
Common Questions / FAQ
Who is user-story-mapping for?
Indie builders and solo PMs who wear the product hat and need a disciplined map from persona to releasable stories.
When should I use user-story-mapping?
In Idea audience research follow-up, Validate scope sessions, or early Build pm when breaking a new product into walking-skeleton releases.
Is user-story-mapping safe to install?
It is documentation and template guidance with no required shell or network calls; still review the Security Audits panel on this Prism page.
SKILL.md
READMESKILL.md - User Story Mapping
# User Story Mapping Example ## Example: Story Map for Freelance Invoicing Product ```markdown ## User Story Map: Freelance Invoicing ### Who #### Segment: - Freelance creative professionals (designers, writers, photographers) #### Persona: - Sarah, 35, freelance graphic designer - Manages 5-10 clients at once - Struggles with invoicing, payment tracking, and follow-ups - Wants to spend less time on admin, more time designing - Currently uses Excel + email, which is error-prone and time-consuming ### Backbone #### Narrative: - Complete a client project from kickoff to final payment without admin hassle #### Activities: 1. Negotiate project scope and pricing 2. Execute design work 3. Deliver final assets 4. Send invoice and receive payment 5. Follow up on late payments ### Steps: **For Activity 1: Negotiate project scope and pricing** - Step 1: Review client brief - Step 2: Draft project proposal - Step 3: Negotiate timeline and budget **For Activity 2: Execute design work** - Step 1: Create initial concepts - Step 2: Share concepts for feedback - Step 3: Iterate based on feedback - Step 4: Finalize design **For Activity 3: Deliver final assets** - Step 1: Export final files in client-requested formats - Step 2: Upload files to shared folder or email - Step 3: Confirm client receipt **For Activity 4: Send invoice and receive payment** - Step 1: Create invoice with project details - Step 2: Send invoice to client - Step 3: Track payment status - Step 4: Confirm payment received **For Activity 5: Follow up on late payments** - Step 1: Identify overdue invoices - Step 2: Send payment reminder - Step 3: Escalate if still unpaid ### Tasks (Sample for Activity 4, Step 1: Create invoice): **MVP (Release 1):** - Task 1: Enter client name and contact info - Task 2: Add line items (description, hours, rate) - Task 3: Calculate total automatically - Task 4: Preview invoice before sending **Release 2:** - Task 5: Add logo and custom branding - Task 6: Save invoice templates for repeat clients - Task 7: Auto-populate line items from project notes **Future:** - Task 8: Generate invoices from time tracking data - Task 9: Multi-currency support ``` --- name: user-story-mapping description: Create a user story map that lays out activities, steps, tasks, and release slices. Use when planning a workflow, backlog, or MVP around the user journey. intent: >- Visualize the user journey by creating a hierarchical map that breaks down high-level activities into steps and tasks, organized left-to-right as a narrative flow. Use this to build shared understanding across product, design, and engineering, prioritize features based on user workflows, and identify gaps or opportunities in the user experience. type: component --- ## Purpose Visualize the user journey by creating a hierarchical map that breaks down high-level activities into steps and tasks, organized left-to-right as a narrative flow. Use this to build shared understanding across product, design, and engineering, prioritize features based on user workflows, and identify gaps or opportunities in the user experience. This is not a backlog—it's a strategic artifact that shows *how* users accomplish their goals, which then informs *what* to build. ## Key Concepts ### The Jeff Patton Story Mapping Framework Invented by Jeff Patton, story mapping organizes work into a 2D structure: **Horizontal axis (left-to-right):** User journey over time - **Backbone:** High-level activities the user performs - **Steps:** Specific actions within each activity - **Tasks:** Detailed work required to complete each step **Vertical axis (top-to-bottom):** Priority and releases - **Top rows:** Essential tasks (MVP / Release 1) - **Lower rows:** Nice-to-have tasks (Future releases) ### Story Map Structure ``` Segment → Persona → Narrative (User's goal) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ [Activity 1] → [Activity 2] → [Activity 3] → [Activity 4] → [Activity 5] ↓ ↓