---
name: design-review-sweep
description: Sweep named pages or screens for UX defects - dead ends, inconsistent type scale, missing empty and error states - and file each finding with evidence and a suggested fix. Use before shipping a flow, after a big UI change, or when a page "feels off" and needs concrete findings instead of vibes.
---

# Design Review Sweep

## When to use

- Pre-ship review of a user flow
- After a large UI change lands
- When a screen feels wrong but nobody can say why

This pack reports defects. It does not redesign, restyle, or rate taste.

## The sweep

Walk every page or screen you were given, in the states listed below.
For each finding, record: page, state, what is wrong, why it hurts, and
one suggested fix small enough to land in a single PR.

### 1. Dead ends

- Screens with no forward action and no way back
- Error states with no recovery path
- Success states that abandon the user ("done." - done, and now what?)

### 2. Type scale

- List every font size in use on the page
- Flag sizes that differ by 1-2px from a sibling (accidental, not
  hierarchical)
- Flag body text under 14px and tap targets under 44px

### 3. Missing states

Every list, form and async panel gets checked for four states:

- **Empty** - zero data, first run. Blank white is a bug.
- **Loading** - is there a skeleton or does the layout jump?
- **Error** - what does the user see when the request fails?
- **Overflow** - 10x the expected items, longest realistic name.

### 4. Consistency

- Same action, two different labels ("Delete" vs "Remove")
- Primary buttons that look different across sibling pages
- Spacing that follows no visible grid

## Output format

One section per page. Findings ordered: dead ends first, then missing
states, then type scale, then consistency. Each finding gets a severity:
blocks-users / annoys / polish.

## Hard boundaries

- Report, do not redesign. One suggested fix per finding, no mockups.
- No taste judgments ("ugly", "dated") - only consistency, states, and
  dead ends.
- If you cannot render a page, say which states you could not verify.
