Visual Regression Guardian (Playwright)
Goal
Prevent visual drift and catch subtle regressions in high-impact UIs.
When to use
- •PRODUCTION+.
- •After tokens and signature patterns exist.
- •Before client handoff.
Minimal inputs (ask only if missing)
- •Routes to baseline.
- •Viewports.
- •Light/dark variants.
Procedure (MUST)
- •Add and configure Playwright.
- •Create
docs/visual_regression.mdfrom template. - •Implement visual tests for key routes and critical states.
- •Define snapshot update policy.
- •Integrate into CI.
Outputs (MUST produce)
- •
docs/visual_regression.md. - •
tests/visual/*.spec.*. - •Playwright config + report artifacts.
Notes
Snapshots are reviewed artifacts, not auto-updated noise.