map-user-journey

Maps a single user's goal achievement into connected scenes with state handoffs and branches.

Updated Sep 4, 2026
One-click install
npx skills add https://github.com/nakamori-naoya/bdd-discovery-and-formulation-plugins --skill map-user-journey-nakamori-naoya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-user-journey
Source: https://github.com/nakamori-naoya/bdd-discovery-and-formulation-plugins/tree/main/plugins/bdd-discovery-and-formulation/internal/map-user-journey
Command: npx skills add https://github.com/nakamori-naoya/bdd-discovery-and-formulation-plugins --skill map-user-journey-nakamori-naoya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often confuse user journeys with use cases, UX journey maps, domain rules, or UI flows, producing documents that mix unrelated concerns. This Skill judges whether a request is truly a User Journey and structures one primary user's path from a starting state to an observable completion through multiple meaningful scenes. ## Core Features & Use Cases - Journey Boundary Judgment: Decides whether a request is a User Journey or should be routed to a use case, UX journey map, domain rule, or data model, based on the reader's question rather than format. - Scene and State Mapping: Builds a journey map with user, goal, start point, end point, completion criteria, scenes with observable responses, and explicit state handoffs between scenes. - Branches and Resumption: Documents branches, interruptions, resumptions, and role handoffs, including what state must persist and whether the path returns to the original goal. - Use Case: Given existing screen drafts and a separate journey document, map how a first-time visitor compares products, purchases, and confirms receipt as one coherent user journey, flagging unresolved connections as open questions. ## Quick Start Judge whether this request is a User Journey and map the scenes from the user's starting state to an observable completion, separating out anything that belongs to use cases or domain rules.

Frequently Asked Questions about map-user-journey

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a user journey map from requirements?▼

Define one primary user, one goal, a start point, an end point, and observable completion criteria first. Then write each scene with its prior state, acting role, one main action, observable response, next state, and the connection to the following scene.

What is the difference between a user journey and a use case?▼

A use case describes the responsibility of a single target system toward its actor, while a user journey covers the continuity of goal achievement across multiple responsibility boundaries or time. The deciding factor is the reader's question, not the number of scenes.

When should I not use a user journey map?▼

Do not use it when the goal is feature usage itself, when there is only one meaningful scene, or when the question concerns emotions and touchpoints (UX journey map), business decisions (domain rules), or persisted facts (data model).

How do I handle branches and interruptions in a user journey?▼

Record which scene branches, what difference causes it, which state it leads to, and whether it rejoins the original goal or ends separately. For interruptions, document the state at interruption and the state needed to resume.

What if the journey's start point or completion criteria are unclear?▼

Write the most plausible option as an explicit hypothesis, note that it is a hypothesis with its rationale and the person to confirm with, and record it as unresolved. Do not present ungrounded connections as facts.