mental-model-mismatch-and-onboarding

What problem does it solve?

It helps you diagnose and fix cases where users misunderstand how your product works because their mental model diverges from the system’s actual behavior.

Core Features & Use Cases

• Diagnose mental-model mismatches using practical signals like repeated support tickets, consistent drop-off at the same step, high undo/cancel rates, and negative feedback about unmet expectations.
• Apply three fix strategies: change the system to match the user’s model, teach the model through onboarding, or surface the divergence at the moment of action.
• Design effective onboarding patterns such as guided first tasks, inline explanations at decision points, progressive disclosure, and “what’s new” panels for model-changing updates.
• Use targeted heuristics like finding the first “surprise,” auditing support-ticket themes, and investigating cancel-rate signals to pinpoint where the mismatch occurs.

Quick Start

Tell your agent: Diagnose the mental-model mismatch from these user symptoms, identify whether to change the system, teach the model, or surface the divergence, then propose onboarding and UI copy changes using guided first task and inline explanation patterns.