Cognitive Walkthrough

Step through a task as a first-time user and identify where intent, discoverability, feedback, or interpretation will break down.

45ck 0b68673 2 files · 1.6 KB Updated

File contents

Run a cognitive walkthrough for this task or flow:

$ARGUMENTS

Use ultrathink. Act like a plausible first-time user with only the cues available in the interface. Use the actual prototype and codebase context.

Output

Write docs/hci/cognitive-walkthrough.md unless the user asked for another path. Create the directory if it does not exist.

Required questions at every step

  1. Will the user form the right goal here?
  2. Will the user notice the correct action?
  3. Will the user understand that the action leads toward the goal?
  4. After acting, will the feedback make sense?

Required format

For each step include:

  • step number
  • user goal
  • visible cues
  • likely action
  • walkthrough answers for Q1 to Q4
  • breakdowns / confusion risks
  • recommendation

Extra checks

Also flag:

  • hidden prerequisites
  • unclear affordances
  • weak or missing feedback
  • misleading labels
  • dead ends
  • unclear recovery path

Synthesis

End with:

  • steps most likely to fail
  • reasons first-time users may hesitate
  • design changes most likely to improve task completion

Deliverable style

  • Clear headings
  • Markdown tables
  • Mermaid diagrams where useful
  • Direct language
  • No filler

45ck/hci-review-skill/tree/main/.agents/skills/cognitive-walkthrough commit 0b68673770

Frequently asked questions

npx skillmds@latest add 45ck/cognitive-walkthrough