ux-flow-designer
Agent: UX/UI Designer
L2 UX/UI designer (Nx) responsible for user flow design, wireframing, prototyping, and component mapping.
Department ethos: ideal-design.md
Skill Description
Designs end-to-end user flows that map every step, decision point, and system response a user encounters while completing a task within the product.
When to Use
- When a new feature or product area needs a user flow before wireframing begins.
- When a product spec defines functionality but does not specify the user's navigation path through it.
- When an existing flow needs to be documented, evaluated, or redesigned based on usability data.
- When multiple teams (design, engineering, product) need a shared reference for how a user moves through a feature.
Workflow
- Identify the user goal: Define the task the user is trying to accomplish, the entry points (how they arrive), and the success condition (what "done" looks like). Deliverable: user goal statement with entry/exit criteria.
- Map the primary flow: Chart the step-by-step path from entry to task completion. Include screens, user actions, and system responses at each step. Keep the primary flow linear and minimal. Deliverable: primary flow diagram.
- Add secondary and error paths: Branch from the primary flow to cover alternative paths (different user choices, permissions, account states) and error paths (validation failures, connectivity issues, permission denials). Deliverable: complete flow diagram with all paths.
- Annotate system behavior: Document what the system does at each step -- data fetching, state persistence, notification triggers, analytics events. These annotations bridge design and engineering. Deliverable: annotated flow with system behavior notes.
- Validate with stakeholders: Review the flow with product (for requirement coverage), engineering (for technical feasibility), and research (for user mental model alignment). Deliverable: validated flow with stakeholder sign-off.
Anti-Patterns
- Designing screens before flows: Jumping to wireframes or visual design without agreeing on the user's path through the experience. Why: screens designed without flow context frequently miss steps, create dead ends, or fail to handle branching -- all of which are expensive to fix after visual design is complete.
- Abstracting away complexity: Collapsing multi-step sequences into single nodes (e.g., "user authenticates") that hide interaction decisions. Why: compressed nodes defer design decisions to engineering, who will implement them without user-centered rationale.
- Ignoring entry context: Designing the flow assuming a single entry point when users may arrive from notifications, deep links, search results, or cross-sell surfaces. Why: each entry point may require different context setting, and ignoring this produces disorienting experiences.
Output
On success: Produces a complete user flow diagram with primary path, secondary paths, error paths, and system behavior annotations. Includes entry/exit criteria and stakeholder sign-off. Delivered as a Figma page or FigJam board linked to the project file.
On failure: Report which flow paths could not be mapped (undefined business rules, unresolved product decisions, missing technical constraints), what partial flow was created, and the open questions blocking completion.
Related Skills
flow-designer -- End-to-end user flows provide the structure; interaction flows add step-level detail.
wireframe-builder -- User flows are a prerequisite for informed wireframing.
spec-translator-design -- Translated design briefs define the feature scope that user flows operationalize.
1---2name: ux-flow-designer3description: This skill designs end-to-end user flows that map the steps a user takes to complete a task. Use when asked to create a user flow diagram, map a journey from entry to completion, or document the navigation structure of a feature. Also consider when a product spec describes functionality without specifying the user's path through it. Suggest when wireframes are being created without an agreed-upon user flow.4---56# ux-flow-designer78## Agent: UX/UI Designer910L2 UX/UI designer (Nx) responsible for user flow design, wireframing, prototyping, and component mapping.1112Department ethos: [ideal-design.md](../../../../departments/design/ideal-design.md)1314## Skill Description1516Designs end-to-end user flows that map every step, decision point, and system response a user encounters while completing a task within the product.1718## When to Use1920- When a new feature or product area needs a user flow before wireframing begins.21- When a product spec defines functionality but does not specify the user's navigation path through it.22- When an existing flow needs to be documented, evaluated, or redesigned based on usability data.23- When multiple teams (design, engineering, product) need a shared reference for how a user moves through a feature.2425## Workflow26271. **Identify the user goal**: Define the task the user is trying to accomplish, the entry points (how they arrive), and the success condition (what "done" looks like). Deliverable: user goal statement with entry/exit criteria.282. **Map the primary flow**: Chart the step-by-step path from entry to task completion. Include screens, user actions, and system responses at each step. Keep the primary flow linear and minimal. Deliverable: primary flow diagram.293. **Add secondary and error paths**: Branch from the primary flow to cover alternative paths (different user choices, permissions, account states) and error paths (validation failures, connectivity issues, permission denials). Deliverable: complete flow diagram with all paths.304. **Annotate system behavior**: Document what the system does at each step -- data fetching, state persistence, notification triggers, analytics events. These annotations bridge design and engineering. Deliverable: annotated flow with system behavior notes.315. **Validate with stakeholders**: Review the flow with product (for requirement coverage), engineering (for technical feasibility), and research (for user mental model alignment). Deliverable: validated flow with stakeholder sign-off.3233## Anti-Patterns3435- **Designing screens before flows**: Jumping to wireframes or visual design without agreeing on the user's path through the experience. *Why*: screens designed without flow context frequently miss steps, create dead ends, or fail to handle branching -- all of which are expensive to fix after visual design is complete.36- **Abstracting away complexity**: Collapsing multi-step sequences into single nodes (e.g., "user authenticates") that hide interaction decisions. *Why*: compressed nodes defer design decisions to engineering, who will implement them without user-centered rationale.37- **Ignoring entry context**: Designing the flow assuming a single entry point when users may arrive from notifications, deep links, search results, or cross-sell surfaces. *Why*: each entry point may require different context setting, and ignoring this produces disorienting experiences.3839## Output4041**On success**: Produces a complete user flow diagram with primary path, secondary paths, error paths, and system behavior annotations. Includes entry/exit criteria and stakeholder sign-off. Delivered as a Figma page or FigJam board linked to the project file.4243**On failure**: Report which flow paths could not be mapped (undefined business rules, unresolved product decisions, missing technical constraints), what partial flow was created, and the open questions blocking completion.4445## Related Skills4647- [`flow-designer`](../flow-designer/SKILL.md) -- End-to-end user flows provide the structure; interaction flows add step-level detail.48- [`wireframe-builder`](../wireframe-builder/SKILL.md) -- User flows are a prerequisite for informed wireframing.49- [`spec-translator-design`](../../../design/head-of-design/spec-translator-design/SKILL.md) -- Translated design briefs define the feature scope that user flows operationalize.