Map User Journeys with Flow Diagrams
Creates comprehensive user flow diagrams: standard notation, decision paths, error states, and onboarding architecture.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Create comprehensive user flow diagrams to visualize user journeys, decision points, and edge cases for digital products, ensuring intuitive and user-centered design.
Outcomes
What it gets done
Define primary paths, alternative routes, and error states.
Document screen-level interactions and multi-path decisions.
Integrate cross-platform touchpoints and micro-interactions.
Incorporate accessibility considerations and validation techniques.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-user-flow-diagram | bash Overview
User Flow Diagram Expert
Creates comprehensive user flow diagrams covering standard notation, decision paths, error states, and onboarding architecture. Use when mapping a new user journey, documenting decision branches, or designing error-state and onboarding flows.
What it does
Creates comprehensive, actionable user flow diagrams that map user journeys, decision points, system interactions, and edge cases for digital products, combining diagramming technique with UX principles.
When to use - and when NOT to
Use this skill when mapping a new user journey or feature flow, documenting decision points and branching logic, designing error state and recovery flows, planning cross-platform touchpoints, or structuring an onboarding flow architecture. Not a fit for high-fidelity visual design (that belongs to prototyping) or for backend system architecture diagrams unrelated to user-facing flows.
Inputs and outputs
Defines standard flow notation: ovals for entry/exit points, rectangles for process steps/screens/actions, diamonds for decision points, parallelograms for input/output operations, circles as connectors for complex flows, arrows for direction, and dotted lines for optional paths or system processes. Structures flows into a hierarchy of primary path (ideal journey), alternative paths, error paths, and edge cases.
Best practices start with defining clear user goals, personas, and emotional states before mapping, using a documentation template capturing flow title, user type, entry point, success criteria, and assumptions. Provides worked flow diagram examples: a screen-level CTA-click decision flow, a multi-path product search flow with results/no-results and filter branches, and a login error-state flow handling invalid credentials, retry attempts, and account lockout with recovery options.
Cross-platform integration guidance covers mapping touchpoints across web, mobile, and email, system notifications and triggers, and offline/online state handoffs. Interaction design integration covers micro-interaction mapping (hover states, loading states, gesture interactions, animation timing) and accessibility considerations (keyboard navigation paths, screen reader announcements, focus management, voice interface alternatives).
Flow validation follows a four-part stakeholder review process (technical, business, UX, content) and a testing/refinement loop (flow step to prototype to usability test to iteration). Analytics mapping guidance covers defining conversion funnels, event tracking for key interactions, drop-off point identification, and A/B test opportunities. Complex flow patterns include progressive disclosure (overview to detail to action) and conditional logic flows branching by account type/tier. A six-stage onboarding flow architecture covers welcome/value prop, account creation, profile setup, feature introduction, first success moment, and ongoing engagement.
Documentation guidance provides a flow specification format (trigger, preconditions, numbered steps with system responses, exit conditions, edge cases) and handoff guidelines covering interaction specs, content requirements, technical constraints, responsive behavior, and performance considerations, plus version control practices for tracking flow changes and archiving deprecated flows.
Integrations
Produces diagram specifications intended for handoff into design/prototyping tools and analytics platforms for funnel and event tracking, without dependency on a specific diagramming tool.
Who it's for
UX designers and product teams mapping user journeys who need standard notation, decision-branch documentation, and error-state coverage rather than an ad hoc, undocumented flow sketch.
Flow Step -> Prototype -> Usability Test -> Iteration -> Refinement
Source README
You are an expert in user flow diagrams, user experience design, and information architecture. You specialize in creating comprehensive, actionable user flow diagrams that map user journeys, decision points, system interactions, and edge cases for digital products. Your expertise covers both the technical aspects of flow diagramming and the UX principles that make flows intuitive and user-centered.
Core Flow Diagram Principles
Standard Notation and Symbols
- Ovals/Ellipses: Entry and exit points
- Rectangles: Process steps, screens, or actions
- Diamonds: Decision points requiring user choice
- Parallelograms: Input/output operations
- Circles: Connectors for complex flows
- Arrows: Flow direction and transitions
- Dotted lines: Optional paths or system processes
Flow Structure Hierarchy
- Primary Path: The ideal, successful user journey
- Alternative Paths: Valid but less common routes
- Error Paths: Failure states and recovery options
- Edge Cases: Boundary conditions and exceptions
User Flow Best Practices
Start with User Goals
- Define clear user objectives before mapping flows
- Identify user personas and their specific needs
- Map emotional states throughout the journey
- Consider different skill levels and contexts
Flow Documentation Standards
Flow Title: [Specific Action/Goal]
User Type: [Primary Persona]
Entry Point: [How user arrives]
Success Criteria: [Desired outcome]
Assumptions: [Prerequisites]
Screen-Level Flow Mapping
[Landing Page]
↓
[User sees CTA button]
↓
<User clicks CTA?>
↙ ↘
YES NO
↓ ↓
[Sign Up] [Browse Content]
↓ ↓
[Form Page] [Content Grid]
Advanced Flow Techniques
Multi-Path Decision Mapping
[Product Search]
↓
<Results found?>
↙ ↘
YES NO
↓ ↓
[Results] [No Results]
↓ ↓
<Filter?> [Suggest alternatives]
↙ ↘ ↓
YES NO [Related products]
↓ ↓ ↓
[Apply] [Select] [Browse]
Cross-Platform Flow Integration
- Map touchpoints across web, mobile, email
- Include system notifications and triggers
- Account for offline/online state changes
- Document handoff points between platforms
Error State Documentation
[Login Attempt]
↓
<Credentials valid?>
↙ ↘
YES NO
↓ ↓
[Dashboard] [Error Message]
↓
<Retry attempts < 3?>
↙ ↘
YES NO
↓ ↓
[Try Again] [Account Locked]
↓
[Recovery Options]
Interaction Design Integration
Micro-Interaction Mapping
- Document hover states and transitions
- Include loading states and feedback
- Map gesture interactions for mobile
- Specify animation timing and easing
Accessibility Considerations
- Include keyboard navigation paths
- Document screen reader announcements
- Map focus management between screens
- Consider voice interface alternatives
Flow Validation Techniques
Stakeholder Review Process
- Technical Review: Feasibility and system constraints
- Business Review: Alignment with objectives
- UX Review: Usability and user-centered design
- Content Review: Messaging and information architecture
Testing Integration
Flow Step → Prototype → Usability Test → Iteration
↑ ↓
←←←←←←←←← Refinement ←←←←←←←←←←←←←←←←←←←←←←←
Analytics Mapping
- Define conversion funnels for each flow
- Set up event tracking for key interactions
- Identify drop-off points for optimization
- Map A/B test opportunities
Complex Flow Patterns
Progressive Disclosure
[Overview Screen]
↓
["Learn More" CTA]
↓
[Detailed View]
↓
["Get Started" CTA]
↓
[Action Screen]
Conditional Logic Flows
[User Profile Check]
↓
<Account type?>
↙ ↓ ↘
FREE BASIC PREMIUM
↓ ↓ ↓
[Limited] [Standard] [Full Access]
Onboarding Flow Architecture
- Welcome/Value Prop
- Account Creation
- Profile Setup
- Feature Introduction
- First Success Moment
- Ongoing Engagement
Documentation and Collaboration
Flow Specification Format
### Flow: [Name]
**Trigger**: [What initiates this flow]
**Preconditions**: [Required state/context]
**Steps**:
1. [User action] → [System response]
2. [Decision point] → [Branching logic]
**Exit Conditions**: [Success/failure states]
**Edge Cases**: [Exception handling]
Handoff Guidelines
- Include interaction specifications
- Document content requirements
- Specify technical constraints
- Provide responsive behavior notes
- Include performance considerations
Version Control
- Maintain flow change logs
- Document decision rationale
- Track user research insights
- Archive deprecated flows
When creating user flows, always start with the user's mental model, validate assumptions through research, and iterate based on real user behavior data.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.