tsunami28/MindNova / .claude/skills/discovery-map-journey
discovery-map-journey
VerifiedMap the customer journey and opportunity landscape for a discovery theme as a diagram, exposing pains and opportunities before any solutioning. Use when the work needs a visual of the experience: phrasings like "map the customer journey", "draw a journey map", "where do users feel pain in this flow", "lay out the opportunity landscape", "visualise the as-is experience", "what are the stages and pain points", or when a Discovery/Spike needs its journey made navigable. Do NOT use to run or synthesise the research itself (that is discovery-synthesize-research), to frame the riskiest assumptions (that is discovery-upsert-hypothesis-canvas), to turn opportunities into stories or create tickets (that is elaboration-upsert-user-story), or to add links to an existing issue (that is governance-enrich-ticket).
Discovery journey map
Owned by the Analyst persona (the journey/opportunity-mapping step). Invoked as /discovery-map-journey.
Map a discovery theme's customer journey, or its opportunity landscape, as a diagram so the stages, actions, pains, and opportunities are visible before anyone proposes a solution. The map is exploratory: it surfaces where the experience hurts and where value could be created, and hands those findings to assumption-framing and upsert-user-story. It does not decide the fix.
The anchor model (read before writing)
The diagram lives in a diagramming tool or board (drawio or a mermaid block in the repo). The
local Spike work item under docs/discovery/spikes/ is the authoritative anchor: it holds
the link to the diagram and a one-line description of what the map shows. If you also write a
repo doc, it carries the inbound story: and a relates.design edge pointing at the diagram.
See docs/ai-sdlc/artifact-graph.md. Do not create work items here; that is
elaboration-upsert-user-story.
Workflow
-
Identify the persona and scenario. Name whose journey this is and the scenario being mapped. A map with no clear actor or scope is not actionable.
-
Lay out the experience. Walk the scenario as stages; under each, capture actions, pains, and opportunities. Keep pains evidence-backed; mark assumptions as such.
-
Produce the diagram. Use mermaid or drawio. Save it to the repo.
-
Optionally write a short discovery doc carrying graph front-matter:
--- story: MN-5 # the Spike key, the anchor phase: discovery step: map-journey relates: design: <repo path to the diagram> --- -
Confirm before writing. Present the diagram and any doc for confirmation.
Guardrails
- Map before you solve. The output is pains and opportunities, not a chosen solution.
- Anchor on the Spike file, not the board. The link must live on the work item file.
- Evidence over opinion. Pains trace to research; mark unknowns as assumptions.
- No em-dashes, no source line numbers.
Next steps
/discovery-upsert-hypothesis-canvas(Analyst/PM) - frame the riskiest assumptions the map surfaced./elaboration-upsert-user-story(PM) - when opportunities become stories./governance-enrich-ticket(any) - link the map to the work item file.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 114k | Updated | Claude CodeCodex | Verified | Install |