user-story-mapping
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.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- user-story-mapping
- type
- component
- 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.
- 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.
02 资源文件 2
- 参考文档examples/sample.md2.1 KB
- 参考文档template.md1004 B
03 SKILL.md 正文
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]
↓ ↓ ↓ ↓ ↓
[Step 1.1] [Step 2.1] [Step 3.1] [Step 4.1] [Step 5.1]
[Step 1.2] [Step 2.2] [Step 3.2] [Step 4.2] [Step 5.2]
[Step 1.3] [Step 2.3] [Step 3.3] [Step 4.3] [Step 5.3]
↓ ↓ ↓ ↓ ↓
[Task 1.1.1] [Task 2.1.1] [Task 3.1.1] [Task 4.1.1] [Task 5.1.1]
[Task 1.1.2] [Task 2.1.2] [Task 3.1.2] [Task 4.1.2] [Task 5.1.2]
[Task 1.1.3] [Task 2.1.3] [Task 3.1.3] [Task 4.1.3] [Task 5.1.3]
... ... ... ... ...
Why This Works
- User-centric: Organizes work around user goals, not engineering modules
- Shared understanding: Product, design, engineering all see the same journey
- Prioritization clarity: Top tasks = MVP, lower tasks = future iterations
- Gap identification: Missing steps or tasks become obvious
- Release planning: Draw horizontal "release lines" to define scope
Anti-Patterns (What This Is NOT)
- Not a Gantt chart: This isn't project management—it's user journey visualization
- Not a feature list: Activities aren't features—they're user behaviors
- Not static: Story maps evolve as you learn more about users
When to Use This
- Kicking off a new product or major feature
- Aligning stakeholders on user workflow
- Prioritizing backlog based on user needs
- Identifying MVP vs. future releases
- Onboarding new team members to the product vision
When NOT to Use This
- For trivial features (don't map what you already understand)
- When user workflows are constantly changing (map stabilizes workflows)
- As a replacement for user stories (the map informs stories, doesn't replace them)
Application
Step 1: Define the Context
Use template.md for the full fill-in structure.
Segment
Who are you building for?
### Segment:
- [Specify the target segment, e.g., "Small business owners using DIY accounting software"]
Quality checks:
- Specific: Not "users" but "enterprise IT admins" or "freelance designers"
Persona
Provide details about the persona within this segment (reference skills/proto-persona/SKILL.md).
### Persona:
- [Describe the persona: demographics, behaviors, pains, goals]
Example:
- "Sarah, 35-year-old freelance graphic designer, manages 5-10 client projects at once, struggles with invoicing and payment tracking, wants to spend less time on admin and more time designing"
Step 2: Define the Narrative
What is the user trying to accomplish? Frame this as a Jobs-to-be-Done statement (reference skills/jobs-to-be-done/SKILL.md).
### Narrative:
- [Concise narrative of the persona's objective, e.g., "Complete a client project from kickoff to final payment"]
Quality checks:
- Outcome-focused: Not "use the product" but "deliver a client project on time and get paid"
- One sentence: If it takes more than one sentence, the scope may be too broad
Step 3: Identify Activities (Backbone)
List 3-5 high-level activities the persona engages in to fulfill the narrative. These form the backbone of your map.
### Activities:
1. [Activity 1, e.g., "Negotiate project scope and pricing"]
2. [Activity 2, e.g., "Execute design work"]
3. [Activity 3, e.g., "Deliver final assets to client"]
4. [Activity 4, e.g., "Send invoice and receive payment"]
5. [Activity 5, optional]
Quality checks:
- Sequential: Activities happen in order (left-to-right)
- User actions: Describe what the user does, not what the product provides
- 3-5 activities: Too few = oversimplified, too many = overwhelming
Step 4: Break Activities into Steps
For each activity, list 3-5 steps that detail how the activity is carried out.
### Steps:
**For Activity 1: [Activity Name]**
- Step 1: [Detail step 1, e.g., "Review client brief"]
- Step 2: [Detail step 2, e.g., "Draft project proposal"]
- Step 3: [Detail step 3, e.g., "Negotiate timeline and budget"]
- Step 4: [Optional step 4]
- Step 5: [Optional step 5]
**For Activity 2: [Activity Name]**
- Step 1: [Detail step 1]
- Step 2: [Detail step 2]
...
Quality checks:
- Actionable: Each step is something the user does
- Observable: You could watch someone perform this step
- Logical sequence: Steps follow a natural order
Step 5: Break Steps into Tasks
For each step, list 5-7 tasks that must be completed.
### Tasks:
**For Activity 1, Step 1: [Step Name]**
- Task 1: [Detail task 1, e.g., "Read client brief document"]
- Task 2: [Detail task 2, e.g., "Identify key deliverables"]
- Task 3: [Detail task 3, e.g., "Note budget constraints"]
- Task 4: [Detail task 4, e.g., "Clarify timeline expectations"]
- Task 5: [Detail task 5, e.g., "List open questions for client"]
- Task 6: [Optional task 6]
- Task 7: [Optional task 7]
**For Activity 1, Step 2: [Step Name]**
- Task 1: [Detail task 1]
...
Quality checks:
- Granular: Tasks are small, specific actions
- User-facing or behind-the-scenes: Include both (e.g., "Send email" and "Receive confirmation")
- Prioritizable: You'll prioritize tasks vertically (top = essential, bottom = nice-to-have)
Step 6: Prioritize Vertically
Arrange tasks top-to-bottom by priority:
- Top rows: MVP / Release 1 (must-have)
- Middle rows: Release 2 (important but not critical)
- Bottom rows: Future / Nice-to-have
Draw horizontal "release lines" to demarcate scope.
Step 7: Identify Gaps and Opportunities
Review the map and ask:
- Are there missing steps or tasks?
- Are there pain points we're not addressing?
- Are there opportunities to delight users?
- Do all activities flow logically?
Examples
See examples/sample.md for a full story map example.
Common Pitfalls
Pitfall 1: Activities Are Features, Not User Behaviors
Symptom: "Activity 1: Use the dashboard. Activity 2: Generate reports."
Consequence: You've mapped the product, not the user journey.
Fix: Reframe as user actions: "Activity 1: Monitor project progress. Activity 2: Summarize work for stakeholders."
Pitfall 2: Too Many Activities
Symptom: 10+ activities across the backbone
Consequence: Map becomes overwhelming and loses focus.
Fix: Consolidate. If you have 10 activities, you're likely mixing activities with steps. Aim for 3-5 high-level activities.
Pitfall 3: Tasks Are Too Vague
Symptom: "Task 1: Do the thing"
Consequence: Can't prioritize or estimate vague tasks.
Fix: Be specific: "Task 1: Enter client email address in the 'Bill To' field."
Pitfall 4: Ignoring Vertical Prioritization
Symptom: All tasks at the same level—no MVP vs. future releases defined
Consequence: No clarity on what to build first.
Fix: Explicitly prioritize. Draw release lines. Force hard choices about what's MVP.
Pitfall 5: Mapping in Isolation
Symptom: PM creates the map alone, then presents it to the team
Consequence: No shared ownership or understanding.
Fix: Map collaboratively. Run a story mapping workshop with product, design, and engineering.
References
Related Skills
skills/proto-persona/SKILL.md— Defines the persona for the story mapskills/jobs-to-be-done/SKILL.md— Informs the narrative and activitiesskills/user-story/SKILL.md— Tasks from the map become user storiesskills/problem-statement/SKILL.md— Problem statement frames the narrative
External Frameworks
- Jeff Patton, User Story Mapping (2014) — Origin of the story mapping technique
- Teresa Torres, Continuous Discovery Habits (2021) — Opportunity solution trees (complementary to story maps)
Dean's Work
- User Story Mapping Prompt (adapted from Jeff Patton's methodology)
Provenance
- Adapted from
prompts/user-story-mapping.mdin thehttps://github.com/deanpeters/product-manager-promptsrepo.
Skill type: Component
Suggested filename: user-story-mapping.md
Suggested placement: /skills/components/
Dependencies: References skills/proto-persona/SKILL.md, skills/jobs-to-be-done/SKILL.md, skills/user-story/SKILL.md, skills/problem-statement/SKILL.md
04 同仓库更多 Skills
designing-in-patterns
Use when designing, planning or auditing UI against a component library — naming surfaces with the repo's pattern vocabulary, deciding reuse versus extend versus new, exploring compositions, or writing the reuse table (component-plan.md, a spec's `## Reuse`, a UI audit). Carries the design method; the repo's own vocabulary, bundle and board rules come from project-context and the designer override.
typeorm
Use when defining TypeORM entities, writing migrations, or building repository/query-builder code in TypeScript. Covers entity and relation decorators, the Data Mapper pattern, migrations, the query builder, transactions, and multi-database configuration.
hono-api
Use when building or extending REST APIs with Hono + @hono/zod-openapi. Covers schema-first route declaration with createRoute, feature-grouped composable routers, a class-based service layer behind interfaces, the strategy pattern for multi-event webhooks, typed request validation, and auto-generated OpenAPI docs.
electrodb
Use when defining DynamoDB entities, modeling indexes, or writing queries/mutations with the ElectroDB ORM. Covers entity schema, access patterns, CRUD operations, update expressions, and single-table design patterns.
atomic-design
Use when structuring or decomposing any frontend UI into reusable components, regardless of framework. Applies Brad Frost's atomic design methodology — atoms, molecules, organisms, templates, and pages — to guide consistent component hierarchy, naming, and composition decisions.
writing-docs
Use when writing, restructuring, or reviewing any prose documentation — a tutorial, how-to guide, reference page, or explanation/conceptual doc — for a public docs site (e.g. Mintlify MDX, docs/, README material), a getting-started guide, an API/CLI reference page, or a "why we built it this way" conceptual page. Applies the Diátaxis framework (see https://diataxis.fr/) — every document belongs to exactly one of the four quadrants (tutorial / how-to guide / reference / explanation), and mixing quadrants inside one document is the single most common documentation failure. Covers the four-quadrant compass for picking the right form, per-quadrant structure templates, an anti-pattern list for quadrant drift, and generic voice/craft rules — repo-specific voice and target output format (e.g. Mintlify MDX) are resolved from the repo's docs-manifest (falling back to project-context), never hardcoded here.