Run a pre-stakeholder review checklist on a journey map. Checks for drop-off risks, missing touchpoints, and Octalysis coverage gaps. Use before sharing a journey with stakeholders, directors, or engineering.
Run a structured pre-stakeholder review on a journey map file. Produce a scored report with clear pass/flag/fail per check. No padding — only findings that require action or acknowledgement.
If $ARGUMENTS is provided, read journeys/$ARGUMENTS.md or journeys/$ARGUMENTS (try both).
If no argument, list available journeys and ask which one to review:
ls journeys/
Read the full file before starting any checks.
Work through all five sections. For each check output: ✅ Pass, ⚠️ Flag, or ❌ Fail with a one-line reason.
| Check | Criteria |
|---|---|
| Phase coverage | At least 2 phases, each with a |
guiding_question| Step count | 5–9 steps total |
| All fields present | Every step has: persona, touchpoint, description, player_goal, business_goal, player_action_description, user_actions, player_emotions, octalysis_drives, success_criteria, pain_points, opportunities, data_sources |
| Branch completeness | If a branch exists, every declared branch option has a corresponding step; branches converge |
| Screenshot refs | Every step has a screenshot: or screenshots: field |
Flag any step where two or more of the following are true — these are the steps where users abandon:
player_emotions contains words like: frustrated, confused, impatient, annoyed, lost, overwhelmedpain_points has 3 or more itemssuccess_criteria is vague (no time, click count, or measurable action)opportunities listed to mitigate the painFor each flagged step: name it, state the risk, cite the specific fields that triggered it.
touchpoint is blank, "N/A", or describes an internal system rather than a user-facing surfaceEvaluate drive usage across the full journey:
Per-step checks:
— why it applies) not just a labelJourney-level checks:
business_goal — flag duplicates or goals that say nothing specific (e.g., "improve conversion")opportunities should be near-term product improvements; ideas should be longer-term or exploratory — flag if both lists contain the same items or if one is empty on every stepOutput in this structure:
## Journey Review: [Journey Title]
Reviewed: [date]
Steps: X | Phases: X | Branches: X
### A. Structure Integrity
[results]
### B. Drop-off Risks
[results — name each at-risk step]
### C. Touchpoint Coverage
[results]
### D. Octalysis Coverage
[results — include drive frequency table if issues found]
### E. Stakeholder Readiness
[results]
---
## Summary
[Blockers] X items must be fixed before sharing
[Flags] X items worth addressing
[Ready to share] Yes / No / With caveats
## Priority fixes
1. [Most critical issue — step name + field + what to fix]
2. ...
Do not summarise what passed. Only list what needs attention.