agentsclimarketplace

Journey mapping

Skill stanislavnianko/product-discovery-claude-skills/plugins/discovery-phase/skills/journey-mapping

[discovery-phase pack · synthesis] Maps the end-to-end journey for a named persona — stages, actions, touchpoints, pain points, emotion line, and opportunity moments. Distinguishes current-state from future-state. Every pain point cites evidence; opportunities link back to opportunity-tree. Produces journey-map.md. Reads personas.md, themes.md, interview-notes/.From its SKILL.md

Install
npx -y skills add stanislavnianko/product-discovery-claude-skills --skill journey-mapping

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

6.0 KB, ~1.3k tokens by cl100k_base, as published. Nobody here has run it

Journey Mapping

Part of the discovery-phase skill pack · synthesis group · reads personas.md (run personas first if missing) and themes.md (from insight-synthesis).

Turns a persona's lived experience into a stage-by-stage map that surfaces where pain concentrates and where opportunity moments hide. Each pain point is evidence-anchored; each opportunity moment links back to the opportunity-tree.md so journey work doesn't drift from prioritized outcomes.

Step 1 — Read context + upstream artifacts

Read discovery-context.md, personas.md, themes.md. If personas.md is missing, recommend running personas first — journeys without a named persona collapse to "the average user" and become useless. Don't block: the BA may proceed with [ASSUMED-persona] for a quick draft, but flag low confidence.

If interview-notes/ exists, scan for chronological narrative — interviews where users walk through "and then I did…" are gold for journey reconstruction. If only support-data-analysis.md is available, the journey will be partial (post-purchase / support phase only).

Step 2 — Set scope

Decide three things up-front; cram all three into one journey and the map becomes unreadable:

  1. Which persona — pick exactly one. If you need journeys for two personas, run this skill twice.
  2. Which journey — onboarding, repeat-purchase, support-resolution, evaluation, churn-recovery, etc. Name it precisely.
  3. Current-state or future-state — current-state maps pain; future-state maps the proposed redesign. Default to current-state unless a feature-scoping decision depends on the future view.

State all three at the top of the artifact. They're constraints — if mid-skill you find yourself blending personas, stop and re-scope.

Step 3 — Stages (3-7)

High-level phases the persona moves through. Examples by journey type:

JourneyTypical stages
OnboardingDiscover → Sign up → First use → Habit formation
Repeat-purchase (B2C)Trigger → Browse → Decide → Purchase → Receive → Use → Repurchase
Support resolutionHit problem → Self-serve attempt → Contact support → Wait → Resolve
Enterprise evaluationAwareness → Shortlist → Pilot → Internal sell → Procurement → Rollout

3 stages = too coarse, 7+ = decompose further or split into two journeys.

Step 4 — For each stage, fill the row

ColumnWhat goes hereEvidence required?
StagePhase name
ActionsWhat the persona literally does (verbs)Light
TouchpointsChannels / tools / people involvedLight
Thinking / GoalWhat they're trying to accomplish in this stageStrong
Pain pointsWhat's broken — friction, confusion, failRequired — cite [I-N], [support-id], [SME-name]
Emotion (1-5)1=frustrated, 3=neutral, 5=delightedStrong
Opportunity momentsWhere the product could interveneLink to opportunity-tree.md

If a row has no pain points but the persona is unhappy, the synthesis is wrong — either the emotion is overstated or you missed a pain. Loop back to evidence.

Step 5 — Draw the emotion line

A simple sparkline across stages: 2 → 1 → 1 → 3 → 4. The dips identify where the product's intervention has the highest leverage. If the line is flat, either the journey is uniformly OK (rare — and your scope is probably wrong) or you didn't probe deep enough.

Step 6 — Identify intervention moments (top 3)

From the rows, pick the top 3 opportunity moments — places where a redesign would shift the emotion line most. Each must:

  • Be tied to a specific stage and pain point
  • Reference an opportunity in opportunity-tree.md (or flag as a new opportunity to add)
  • Note what evidence makes this stage high-leverage (e.g., "8 of 12 interviews mentioned drop-off here")

These three moments become inputs to feature-scoping and mvp-definition.

Step 7 — Pressure test (4 checks)

TestQuestionFix
Persona-fitDoes each stage make sense for the named persona? Or did you slide into "average user"?Re-anchor on the persona's role/context
Evidence per painEvery pain point has a citation?Drop unsupported pains or escalate to "open question"
Emotion groundedIs the emotion score derived from a quote, not a guess?Replace guesses with quotes or [ASSUMED]
Opportunity linkTop-3 moments link to opportunity-tree.md?Add to opportunity tree or revise — journeys that don't feed downstream are decoration

Step 8 — Write artifact

Output: ./discovery/journey-map.md — see ./template.md.

Append to _log.md: [journey-mapping | YYYY-MM-DD] persona: <label>; journey_type: <onboarding|...>; state: <current|future>; stages: <N>; top_pain_count: <K>.

Anti-patterns

  • Feature-led journey. "User clicks button → user sees screen" is a UX flow, not a journey. Lead from the persona's intent, not the product's UI.
  • Generic personas, generic journey. Without a sharp persona, every stage becomes vague.
  • Missing emotion line. Pure-cognitive journeys hide where redesign actually matters.
  • Future-state cosplay. Future-state maps without an evidence-backed current-state are wishful thinking.
  • One mega-journey covering 12 stages. Split. Always split.
  • Journey that doesn't feed opportunity-tree.md. Journey work that doesn't change downstream decisions is decoration.

What ships with it: 1 file

1.4 KB alongside SKILL.md

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.