MANDATORY PREPARATION

Read frontend-design and follow its Context Gathering Protocol. Reuse available context and ask only about consequential gaps. Additionally gather: the "aha moment" you want users to reach, and users' experience level.

Consult the onboarding UX when deciding first-run sequencing, activation milestones, setup-wizard scope, tours vs checklists vs contextual onboarding, progressive permission requests, or how returning users should re-enter an unfinished flow. Consult the empty-state patterns when zero-data surfaces are part of the onboarding journey. Consult the cognitive load when deciding what to hide, sequence, or progressively disclose for first-time users. Consult the behavioral design when onboarding depends on priming, framing, honest progress cues, or completion momentum. Consult the permissions and roles UX when onboarding depends on request-access flows, role selection, admin-vs-member setup differences, or capability boundaries that users need explained early. Consult the ux-writing reference when onboarding clarity depends on labels, hints, reassurance copy, or CTA wording. Consult the status communication when onboarding needs notification preferences, summary modes, quiet hours, reminder settings, or interruption-level decisions. Consult the loading feedback and perceived performance when setup, imports, or first-run data preparation create waits that need honest progress and trust-preserving feedback. Consult marketing copywriting when onboarding needs stronger setup promises, first-win framing, permission prompts, or upgrade / invite messaging. Consult copy editing sweeps when revising existing onboarding copy in focused passes.

Create or improve onboarding experiences that help users understand, adopt, and succeed with the product quickly.