Skip to content

borghei/Claude-Skills / project-management/execution/story-mapping

story-mapping

Verified

Builds a user story map (journey backbone, ranked tasks, release lines) to agree an MVP and release order. Use when defining an MVP, slicing releases, or turning a flat backlog back into a user journey.

User Story Mapping Expert

Overview

Visualize the user journey and translate strategy into prioritized, deliverable work using Jeff Patton's user story mapping technique. Story maps shift teams from feature-first thinking to flow-first thinking -- understanding the complete user experience before deciding what to build and in what order.

A story map is a 2D grid: the backbone (activities → steps) runs left-to-right in the order users experience the journey, the body (tasks) hangs below each step ranked top-to-bottom by priority, and a horizontal MVP line separates Release 1 from later. See the playbook reference for full anatomy and the 6-step build sequence.

Done looks like: a backbone of user activities and steps in journey order; tasks under each step ranked by priority; a release-1 line that delivers a working end-to-end journey (a walking skeleton, not one finished column); later slices named by the outcome each adds; the map reviewed with the people who will build it.

When to Use

  • MVP definition -- Draw a clear line between "must ship" and "can wait."
  • Release planning -- Sequence work across multiple releases or sprints.
  • Cross-team alignment -- Give multiple teams a shared understanding of the user journey.
  • Backlog reorganization -- Restore context and priority to a flat backlog.
  • New product kickoff -- Decompose a vision into work from scratch.

When NOT to Use

  • Purely technical infrastructure work with no user journey (use technical spikes).
  • The team already has a well-prioritized, context-rich backlog.
  • Single-feature work that doesn't span multiple user activities.

Clarify First

Before building the map, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

  • The user and their end-to-end journey: who travels it and the activities → steps in order (defines the backbone, the left-to-right spine of the map).
  • The target release / MVP: what must ship first vs can wait (sets where the MVP line is drawn between Release 1 and later).
  • The map's goal: MVP definition vs release sequencing vs cross-team alignment (changes how the body tasks are sliced and prioritized).

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

Anti-Patterns

Skipping the walking skeleton

Mistake: Release 1 polishes sign-up and activation but has no cards under Pay or Upgrade, so users can't finish a real workflow. Why it happens: The first steps of the journey are the most familiar, so the team fills them in depth before reaching the end. Instead: Make R1 the thinnest end-to-end slice: 1-3 stories under every backbone step, each minimal. If any backbone column has zero R1 cards, there is no walking skeleton yet. Enrich steps in R2 where data shows friction.

Implementation tasks on the map

Mistake: Cards read "set up Postgres", "configure Auth0", "write /users endpoint" instead of what the user does. Why it happens: Engineers think in build tasks, and those tasks feel like the real work to plan. Instead: Every card describes a user action ("enter email and password", "verify via email link"). Keep implementation work as sub-tickets in the tracker. If a card describes a system or code, rewrite it as a user story.

Building the map alone

Mistake: The PM builds the map over a weekend and presents it to the team on Monday. Why it happens: Solo work is easier to schedule than a workshop, and the PM already holds most of the context. Instead: Build the map in a workshop with PM, design lead, eng lead and someone close to customers, using the facilitation guide in references/playbook.md. The shared understanding is the output. A map with a single author should be redone as a workshop.

Seven more, each with a bad and a good example: references/red-flags.md.

References

  • references/playbook.md — read this when building a map: story-map anatomy, the 6-step build sequence, the artifact template, map patterns (walking skeleton / thick slice / progressive enhancement), the workshop facilitation guide, troubleshooting, and success criteria.
  • references/red-flags.md — read this before using a map for release planning: common ways a story map goes wrong with bad/good quoted examples and fixes.

Scope & Limitations

In Scope: User story map creation, backbone and body decomposition, release slice definition, MVP scoping, facilitation guidance, workshop planning, template and pattern library.

Out of Scope: Individual story writing and acceptance criteria (see job-stories/ or product-team/agile-product-owner), technical architecture decisions, detailed effort estimation, sprint planning mechanics.

Important Caveats: Story maps are planning tools, not contracts. They should be updated as the team learns. A map created before building will always be wrong in details -- the value is in the shared understanding, not the artifact itself. Jeff Patton: "The map is not the territory; the conversation is the territory."

Story maps place the whole journey; to cut one oversized story use story-splitting/, and to write each task as a backlog item use wwas/.

Integration Points

IntegrationDirectionWhat Flows
job-stories/Receives fromJTBD discovery canvas defines the narrative for mapping
create-prd/Feeds intoRelease 1 tasks inform PRD scope (Sections 7 and 8)
prioritization-frameworks/ComplementsRICE scoring prioritizes within release slices
brainstorm-okrs/ComplementsRelease slices align with quarterly OKR targets
outcome-roadmap/Feeds intoRelease slices map to Now/Next/Later roadmap horizons
wwas/Feeds intoTasks become WWAS backlog items with strategic context

Further Reading

  • Jeff Patton, User Story Mapping (2014)
  • Jeff Patton, "The New User Story Backlog Is a Map" (2005)
  • Inspired by Productside story mapping workshops

Files

FilePurpose
references/playbook.mdAnatomy, build sequence, template, patterns, workshop guide
references/red-flags.mdCommon mapping failures with fixes
examples/wayfinder-mobile-onboarding-story-map.mdWorked story map for a mobile onboarding flow
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall