design-review

To catch visual regressions before browser tests, you can run an automated design review that compares rendered UI screenshots against aesthetic direction and ux-brief criteria, generating a structured pass/fail report.

A visual regression check against an aesthetic direction is a process that captures desktop and mobile screenshots of affected routes and uses a Haiku-vision agent to compare them against your ux-brief.md for design-contract compliance.

You can automate UI design analysis by starting a dev server to render updated UI files, capturing screenshots across desktop and mobile states, and dispatching a vision agent to evaluate visual compliance.

Yes, an aesthetic-direction.md file is a required prerequisite. The design review process performs pre-flight checks against this file to detect changed UI files and establish the visual scope before capturing screenshots.

When a visual regression audit finds UI issues, it updates a structured design-review.md with findings and next steps, and escalates the analysis to Sonnet or Opus models for deeper evaluation and recommended actions.

You should run a visual regression audit during the handoff between the develop and browser-test stages, specifically for features with UI changes, to ensure visual compliance before automated testing begins.