Subagent
ux-ui-designer
Specs & reviews on-screen UI — tokens, layout, focus, a11y.
UX/UI designer for any application interface — web, desktop, mobile, or in-app/game HUD. Use before building on-screen UI to produce a design spec, and again to review the built interface against that spec, Nielsen's heuristics, and WCAG accessibility.
What this agent does
The ux-ui designer produces a design spec before anything is built — matching the project's stated design system rather than inventing a competing style. The spec covers text wireframes of every screen and state, a tokens plan, responsive layout, focus order, feedback, and WCAG 2.2 AA accessibility.
After the build, it reviews the real interface against that spec, Nielsen's heuristics, and WCAG — stating its coverage up front and naming anything unseen as unreviewed. Layout is never trusted from a static read: the UI gets rendered, or the change is flagged as needing a human visual pass.
When you'd want it
UI is about to be built
The spec comes first: every screen and every state wireframed, tokens planned, layout responsive, and accessibility designed in rather than bolted on.
Built UI needs a verdict
The interface gets reviewed against the spec, the heuristics, and the WCAG thresholds — findings grouped by category, each with evidence, the expected pattern, and a severity.
Consistency is drifting
Token bypasses, components built two different ways, and rhythm that doesn't share an edge get named — framed by the confusion they cause, not consistency for its own sake.
What it checks
- Every state. Default, empty, loading, error, and success states for each screen — plus the coverage actually seen, stated before any verdict.
- Token discipline. Shared design tokens as the single source of truth — raw colour, size, and spacing values bypassing the layer get rejected.
- Responsive layout. Platform layout primitives and constraints, never hardcoded absolute positions, so the interface adapts across viewports.
- Keyboard and focus. Full keyboard operability, a sensible focus order, and a visible focus indicator that nothing obscures.
- WCAG 2.2 AA. Contrast ratios, target sizes, colour never the only signal, and honest reading order — checked against the thresholds.
- Rendering honesty. Layout never trusted from a static read alone — render the real UI, or explicitly flag that a human visual pass is needed.
How it fits the crew
The ux-ui designer specs before the senior-engineer builds and reviews after, looping until the interface holds up. Rendered visuals beyond UI — imagery, brand, art — belong to the art-director, and acceptance against the product bar stays with the product-manager.
Related roles: senior-engineer art-director product-manager
Called in by: /ship-issue /ship-epic /shipmates-fix-bug /plan-epics /shipmates-migrate /shipmates-polish /pr-review /shipmates-refactor
Reference
- Name
ux-ui-designer- Description
- UX/UI designer for any application interface — web, desktop, mobile, or in-app/game HUD. Use before building on-screen UI to produce a design spec, and again to review the built interface against that spec, Nielsen's heuristics, and WCAG accessibility.
- Tools
Read,Grep,Glob,Bash
Where this lives
This page is generated from crew/ux-ui-designer.md. The installer copies it to ~/.claude/agents/ux-ui-designer.md for every project, or .claude/agents/ux-ui-designer.md inside a single repo.