ux-compare

1# UX Compare
2 
3Read N pattern libraries produced by `ux-extract` and synthesise a comparison. Answers questions like:
4 
5- *"Across claude.ai, Linear, Notion, Vercel, and Superhuman — how are empty states handled?"*
6- *"Which apps use keyboard shortcuts, and what's the shared vocabulary?"*
7- *"When we build our billing page, should we follow convention or deliberately break it?"*
8 
9A single extract is a reference point. Multiple extracts are a design library. A comparison is a *decision aid* — it turns the library into "here's what to do and why".
10 
11## When to use
12 
13- **Before a build** — comparing 3–5 references for the feature class you're about to build reveals the convention and the tradeoffs
14- **During a design review** — "this pattern isn't in any of the 5 references we've extracted — is that deliberate?"
15- **For team alignment** — shared reference for a design decision
16- **To produce a design brief** — convergent patterns become the baseline; divergent patterns become the discussion
17 
18## Inputs
19 
20### Available libraries
21 
22First, discover what's available. Pattern libraries live at:
23 
24- `docs/ux-extracts/<app-name>/pattern-library.md`
25- `.jez/artifacts/ux-extracts/<app-name>/pattern-library.md`
26 
27List everything you find. Show the user the inventory with the extraction date for each so they can spot stale ones:
28 
29```
30Available pattern libraries:
31- claude.ai      (extracted 2026-03-12)
32- linear.app     (extracted 2026-02-28)
33- notion.so      (extracted 2026-01-15) ← 3 months old
34…