user-walkthrough

Solid

Walk one complete journey against the running build with a declared knowledge state, name observable UX failure patterns, and refuse to invent whether a person would want the product.

AI & Automation 103 stars 15 forks Updated today MIT

Install

View on GitHub

Quality Score: 85/100

Stars 20%
67
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# User walkthrough Screen reviews do not prove a journey. When `pnpm design:route` includes this skill, walk its declared scope: the changed path for a local journey change, the agent-handoff path for a handoff change, or the continuous north-star path for a new surface. ## Authority and limit Judge facts that live in the artifact: vocabulary, next-step visibility, control discoverability, feedback, perceived reversibility, waiting state, missing paths, and visible craft. Each can be proven by pointing at the screen. Do not claim facts that live in a person's mind: whether they want it, will return, recommend it, or pay. Simulated users mispredict real people inconsistently. “No observable stall” does not mean “they like it.” Demand, retention, and willingness come only from real people. ## Name patterns, not emotions Every finding carries a reusable pattern name. “This person will feel frustrated” is invention; “dead-end CTA—the primary button opens an empty destination” is a checkable pattern. Common patterns: | Pattern | Definition | |---|---| | Dead-end CTA | the strongest action leads nowhere useful | | Implementation-language label | the label describes program work, not the user's outcome | | Gate before value | the product requires something before showing why it matters | | Silent wait | work is happening with no visible progress | | Unknown reversibility | a risky-looking action shows no undo or cancellation path | | Builder vocabulary leak | internal develo...

Details

Author
wlsdks
Repository
wlsdks/ontology-atlas
Created
4 months ago
Last Updated
today
Language
TypeScript
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category