Files
pm-claude-skills/exports/windsurf/pm-figma/figma-user-flow-planner/figma-user-flow-planner.md
T
mohitagw15856 036511ab3e Windsurf + Aider targets, MCP server, and demo placement (#33)
Broadens both reach (more tools) and content types (an MCP server), continuing
the multi-platform story.

Windsurf + Aider:
- build-exports.mjs gains two platforms: exports/windsurf/*.md (workspace rules,
  trigger: model_decision) and exports/aider/*.md (conventions for `aider --read`).
  Now 5 platforms (ChatGPT, Gemini, Cursor, Windsurf, Aider).
- install.sh + bin/cli.mjs install both (windsurf -> .windsurf/rules, aider ->
  .aider/skills with a --read hint); generated README index is excluded from copies.
- One-line windsurf-install.sh / aider-install.sh wrappers for parity.

MCP server (new content type):
- mcp/server.mjs — zero-dependency stdio MCP server exposing list_skills,
  search_skills, get_skill. Published as a second bin (pm-claude-skills-mcp).
  Logs to stderr; reads bundled skills/ at startup. mcp/README.md documents
  client config.

Also: README hero "See it in action" demo placement (ready to swap in a GIF;
recording guide in web/docs-assets/README.md), Works-With table + exports +
install docs updated, CHANGELOG Unreleased. package.json files/bin updated.


Claude-Session: https://claude.ai/code/session_016JWn5jRD5tcEFKrubjQ6Px

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-17 23:15:38 +01:00

3.1 KiB

trigger, description
trigger description
model_decision Plan user flows and screen states for a Figma design before any designing starts. Use when asked to plan a user flow, map out screens for a feature, define screen states, plan a Figma file structure, or work out what needs to be designed before opening Figma. Produces a complete flow map with all screens, states, entry/exit points, and a suggested Figma page structure.

Figma User Flow Planner Skill

Plans what needs to be designed before a pixel is touched — mapping all screens, states, entry points, and edge cases so designers do not discover missing states mid-build.

Required Inputs

  • Feature or task being designed
  • User type (who performs this flow?)
  • Platform (iOS / Android / Web / Multi-platform)
  • Starting point (where does the user begin?)
  • Known edge cases (optional)

Output Structure

1. Flow Overview

Feature, user, goal, entry points, success exit, failure exits.

2. Screen Map

# Screen name Type Triggered by Notes
1 [Screen] New/Modal/Drawer/Toast [What triggers] [Considerations]

Screen types to cover: entry, happy path, loading, success, error (network/validation/permission), empty, first-time/onboarding, edge cases.

3. State Matrix

[Screen name]

State Trigger Visual change Action available
Default Page load [Description] [What user can do]
Loading User taps action Skeleton/spinner None
Error API failure Error message Retry/Go back
Empty No data Empty state [CTA]

4. Decision Points

Decision: [Name]

  • If yes: [Screen N]
  • If no: [Screen X]

5. Suggested Figma File Structure

Feature name/
- Cover
- Flow Map
- Happy Path
- Error States
- Empty States
- Edge Cases
- Handoff

6. What Not to Design Yet

[Explicit out-of-scope items — prevents scope creep]

Quality Checks

  • All three state types covered: loading, error, empty
  • All decision points mapped with both branches
  • Entry points include all realistic user paths
  • Out-of-scope section is explicit
  • Figma file structure matches screen map

Anti-Patterns

  • Do not plan only the happy path — all error states, empty states, and edge cases must be mapped before designing starts
  • Do not produce a flow map that doesn't match the Figma file structure — the page structure must reflect the flow map
  • Do not define screens without specifying all required states — a screen without its variants is an incomplete design scope
  • Do not start designing before entry and exit points are fully documented — unclear boundaries cause scope creep
  • Do not plan user flows without tying each step back to a user goal — every screen must justify its existence

Example Trigger Phrases

  • "Plan the user flow for [feature] in Figma"
  • "What screens do I need to design for [feature]?"
  • "Map out the states for [feature] before we start designing"
  • "Help me structure my Figma file for [feature]"
  • "What do we need to design before handing this to the developer?"