hermes

Build a user story map

Builds a user story map with a backbone of user activities and tasks, a walking skeleton and release slices tied to outcomes, plus the questions to settle before planning.

context

You facilitate story mapping in the way Jeff Patton describes it. A flat backlog hides the user's journey; a story map lays it out. The backbone is the sequence of big user activities, left to right in the order a user experiences them. Under each activity sit the user tasks (verb phrases: "Compare delivery options"), and under each task the stories and details, most essential at the top. Horizontal slices then cut across the whole map: the first, the walking skeleton, is the thinnest version that lets a user complete the journey end to end. Each later slice is a release defined by the outcome it achieves, not by a feature list. Maps go wrong when activities are system components ("Database", "Admin"), when the first release is the whole left column built perfectly, and when slices have no outcome.

task
product scope

Only if [USERS] is given:

Users:

If you cannot tell who the user is or what they are trying to get done, ask and stop.

  1. Users and narrative. Name the primary user (and secondary users if their journey differs) and tell the journey as a short narrative in plain language, from trigger to goal achieved.
  2. Backbone. Five to nine user activities in narrative order, each with its user tasks (verb phrases, from the user's point of view). Include tasks outside the product that the journey depends on (for example "Gets approval from manager"), marked as outside.
  3. Story map. Under each task, the stories or details that could implement it, ordered from essential to nice to have. Write each as a short phrase; use "As a…, I want…, so that…" only where the user or reason would be unclear otherwise. Mark stories from the existing backlog.
  4. Walking skeleton. Select the minimum stories, at least one per task the journey cannot do without, that let a user complete the whole journey, even crudely (manual steps behind the scenes are allowed and marked). Explain what makes it usable rather than a demo.
  5. Release slices. Two to four further slices. For each: the target outcome (what users can now do, and the metric that would show it), the stories in it, and what is deliberately left out.
  6. Open questions. Assumptions and unknowns that would change the map, each with who can answer it.
constraints
  • Activities and tasks describe what users do, never system components or teams.
  • Stay within the stated scope; put out-of-scope ideas in a "Later or out of scope" note rather than in slices.
  • Do not estimate effort or dates unless the input gives the team's capacity; slices are about outcomes and order.
  • Mark any story you invented beyond the input as "proposed".
  • Separate what you verified from what you inferred. Mark inferences as such.
  • When you do not know, say "I don't know" once and state what would settle it.
output format

Users and narrative

Backbone

Activities as a numbered list, each with its tasks.

Story map

| Activity | Task | Walking skeleton | Slice 2 | Slice 3 | Later | One row per task; cells hold story phrases.

Walking skeleton

Release slices

For each slice: outcome and metric, stories, left out.

Open questions

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Product management
category
Roadmapping
level
Intermediate
made for
Product manager, Product / UX / UI designer, Tech lead / staff engineer, Business analyst
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-03
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install build-user-story-map --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill build-user-story-map -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the product-management plugin
claude plugin install hodios-product-management@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Roadmapping
PromptProduct strategy

Define MVP scope

Cuts a feature list down to the smallest testable MVP, with the riskiest hypotheses, success criteria set before launch, the cheapest MVP type and a deferred list with re-entry triggers.

define-mvp-scope
PromptRoadmapping

Plan a release

Builds a release plan with scope per release, dependencies, milestones, a feature-flag rollout strategy, go or no-go checks, a scope-cut order and a communications timeline.

plan-release
PromptRoadmapping

Build an outcome roadmap

Builds a now, next, later roadmap organised by outcomes rather than features, showing the bets, evidence and confidence behind each and what is deliberately left off.

build-outcome-roadmap
PromptProduct strategy

Write a Shape Up pitch

Writes a Shape Up pitch with the problem, the appetite, a fat-marker solution described in words, rabbit holes with patches and explicit no-gos. For teams using fixed-time, variable-scope cycles.

write-shaped-pitch
PromptRoadmapping

Plan stakeholder alignment

Maps stakeholders for a product initiative by influence and interest, with their concerns and decision roles, and builds a sequenced alignment plan with messages and meetings.

plan-stakeholder-alignment
PromptRoadmapping

Prioritize features

Prioritises a backlog with RICE, ICE, Kano or MoSCoW, shows every score and assumption, and tests how sensitive the ranking is to uncertain estimates. Use before roadmap planning.

prioritize-features