---
name: design-polish
description: Build or refine user interfaces with restrained, editorial, quiet-but-not-empty taste. Use for visible frontend work involving hierarchy, spacing, typography, color, interaction, accessibility, or generic AI-looking UI.
---

# Design Polish

Make the interface feel authored, legible, and alive. The target is restraint with intent, not generic minimalism.

## Start With Evidence

Open the real surface, capture the relevant state, identify the primary user task, and name visible problems from evidence. Fix in this order: hierarchy, layout, spacing, typography, color, depth, motion, and detail.

## Working Rules

- Give each screen one obvious center of gravity.
- Use size, weight, position, and spacing before adding color.
- Preserve useful density; empty space should clarify relationships.
- Keep the type system small and purposeful.
- Reserve strong accents for meaningful states or focal actions.
- Use motion to explain state, continuity, focus, or causality.
- Protect project-specific brand decisions and distinctive choices.

## Remove Default AI UI

Remove or justify gradient blobs, generic violet branding, card salad, emoji iconography, glows, glass, low-contrast text, stock component styling, generic hero copy, and sterile emptiness with no hierarchy or point of view.

## Accessibility Floor

Use semantic HTML, labeled inputs, visible focus states, logical keyboard order, sufficient contrast and target sizes, reduced-motion support, and more than color alone to communicate state.

## Verify The Painted Result

Run the actual application. Inspect the primary viewport and responsive targets. Exercise affected hover, focus, disabled, loading, error, empty, and overflow states. Fix visible failures before declaring the interface finished.
