agentleFS
dembrandtdembrandt/dembrandt-skills/skills/user-flows-and-guided-paths/SKILL.md

user-flows-and-guided-paths

Skill194 starsChanged 4 months agoMITView on GitHub

Guided multi-step paths and wizards. Use when designing onboarding, checkout, setup sequences or any multi-step journey.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Only guide when the task genuinely has a natural order.

    line 58
  2. Distinctive:

    Use a wizard when:

    line 64
  3. Distinctive:

    Step indicator: Always show the user where they are in the sequence and how many steps remain.

    line 81
  4. Distinctive:

    Back navigation: Always available. Users must be able to go back and change earlier decisions without losing their progress on later steps.

    line 83
  5. Distinctive:

    After completing a flow, return the user to a meaningful place in the hierarchy — not to a generic home screen

    line 111

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

User Flows and Guided Paths

Related features that belong together should be experienced as a single coherent journey — not as separate screens the user has to navigate between manually. A well-designed flow feels inevitable: each step leads naturally to the next, the user always knows where they are and what comes next, and the path fits the product's information hierarchy.

When to Guide vs. When to Let Users Explore

ScenarioPattern
Linear process with a clear end goal (checkout, signup, setup)Guided step-by-step flow or wizard
Complex task that benefits from breaking into stagesWizard with progress indicator
Feature discovery across an existing productContextual tooltips or coach marks
User returning to complete something they startedResume prompt with clear re-entry point
Open-ended exploration (dashboard, settings)Free navigation — do not force a flow

Only guide when the task genuinely has a natural order. Forcing a wizard onto a non-sequential task frustrates users who already know what they want.

A discovery cue is a bounded reminder. A badge, glow or nudge pointing at a hidden feature shows only while there is something unseen, ends on first open, and stops after a fixed cap of showings set once for the product. Start with about three and change it only on evidence. Left on for as long as the content exists, it becomes noise the user learns to ignore.

The Wizard Pattern

Use a wizard when:

  • The task has 3 or more sequential steps
  • Later steps depend on decisions made in earlier steps
  • Doing all steps on one screen would overwhelm the user

Wizard anatomy

[Step indicator: 1 of 4]

Step title

  [Form content for this step]

[Back]  [Continue →]

Step indicator: Always show the user where they are in the sequence and how many steps remain. A progress bar or numbered steps both work — numbered steps are clearer when step names are meaningful.

Back navigation: Always available. Users must be able to go back and change earlier decisions without losing their progress on later steps.

Forward navigation: Disabled until the current step is complete. Validate on Continue, not on Submit at the end.

Exit path: Make it clear how to abandon the flow without losing partial progress. Autosave drafts where possible.

Step design principles

  • One primary decision or input group per step — don't overfill steps
  • Step titles should describe the user's goal, not the system's: "Your delivery address" not "Address input"
  • Optional steps should be clearly marked and skippable
  • The final step should show a summary before committing

Purchase and Conversion Flows

Purchase flows have an additional constraint: every unnecessary step reduces conversion. Design for the shortest path to completion.

  • Collect only what is required at each stage — defer optional information
  • Show a persistent order summary so the user always sees what they are buying
  • Surface trust signals near payment steps (security badges, return policy)
  • Confirmation step before payment: show total, delivery, items — one last review
  • Post-purchase: immediate confirmation with clear next steps ("Your order is confirmed. We'll email you when it ships.")

Fitting Flows into the Product Hierarchy

A guided path should feel like it belongs to the product — not like it has opened a separate experience.

  • The visual style, typography, and components inside a flow should match the rest of the product
  • Navigation chrome (sidebar, top nav) can be hidden during a flow to reduce distraction, but the brand header should remain visible
  • After completing a flow, return the user to a meaningful place in the hierarchy — not to a generic home screen
  • Deep-linking into a flow should work: a user who arrives at step 3 via email link should see step 3, not step 1

Review Checklist

  • Does the flow have a clear start, a logical step order, and a definite end?
  • Is a progress indicator visible at every step?
  • Can the user go back to any previous step without losing later progress?
  • Is each step focused on one decision or input group?
  • Are step titles written in user language, describing their goal?
  • Does the final step show a summary before the irreversible action?
  • After completion, does the user land somewhere meaningful in the product?
  • Does the flow visual style match the rest of the product?
  • Does each feature-discovery cue end on first use and after a capped number of showings?

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.