---
name: ui-review
description: Find mechanical token, contrast, state, spacing, motion, and touch-target issues in interface source files.
---

# UI review

Use after implementation to find static interface issues. Do not treat a clean lint run as proof of visual quality or accessibility conformance.

## Procedure

1. Load [the review checklist](references/review-checklist.md) and the relevant component specs through [the component index](../components/references/index.md).
2. Run `python scripts/ui_lint.py PATH...`; pass token files when the project stores them elsewhere.
3. Fix ranked findings using token variables and component `*.spec.json` values; inspect the changed screen visually and with keyboard/accessibility tools when available.
4. Report static findings and visual checks separately. State what was not inspected.

## Inputs and outputs

- Inputs: HTML, CSS, JSX, TSX, generated tokens, component numeric specs.
- Outputs: ranked findings with file, line, rule, and fix; plus separate human review evidence.

## Reference routing

| Need | Load |
|---|---|
| Review order and static-check limits | [Review checklist](references/review-checklist.md) |
| Exact component numeric rules | [Component index](../components/references/index.md) |