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.
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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Open questions. Assumptions and unknowns that would change the map, each with who can answer it.
- 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.
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
use in
npx @hermes-hq/hodios install build-user-story-map --target claude-codenpx skills add hermes-hq/hodios-dist --skill build-user-story-map -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-product-management@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of RoadmappingDefine 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-scopePlan 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-releaseBuild 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-roadmapWrite 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-pitchPlan 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-alignmentPrioritize 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