/verify-visual
Visually verify a UI change against the design intent or a reference.
Pre-flight
- Confirm
chrome-devtoolsMCP plugin is installed (perplugin-preflightrule) - Confirm dev server is running (use
/previewfirst if not — site needs HTTP, notfile://)
Steps
- Acknowledge what you're verifying — re-state the change and the reference (1 line).
- Navigate to
http://localhost:8000/<page>.htmlvia chrome-devtoolsnavigate. - Screenshot the relevant element (or full page) via
take_screenshot. - Self-critique on the 4 axes (per
ui-iteration-looprule):- Color — palette, contrast, accent
- Typography — font, weight, size, line-height
- Spacing — padding, margin, gap, rhythm
- Ornamentation — borders, shadows, decorations
- Show user the screenshot + 1-line verdict (match / off / specific axis).
Output format
Verifying <change> against <reference> — 4 axes:
- Color: ✓
- Typography: ✓
- Spacing: ⚠ tighter than reference
- Ornamentation: ✓
Screenshot: <path>
Verdict: 80% match. Tighten rhythm next?
When NOT to use
- Micro-edits (single property tweak, copy fix) — skip per
output-brevityrule - Themes other than default need separate verification — verify each theme that's affected
Round-file context
When iterating via index_v{N}_round{M}.html files (per the iterative workflow):
- Always serve the round file:
http://localhost:8000/index_v{N}_round{M}.html - Compare against the previous round file or against
index.html(current deployed) - Don't promote
round3toindex.htmluntil visual verification on round3 passes
Lighthouse integration
For performance / SEO / a11y audits beyond visual, use chrome-devtools MCP's lighthouse_audit (Chrome's built-in Lighthouse — zero install). For headless / CI runs, see agent-harness/recommendations/web-auditing.md.
Companion rules
ui-iteration-loop— when user provides a visual reference, run the autonomous 8-iteration loopplugin-preflight— verify chrome-devtools MCP installed before first invocationtool-proactivity— fire automatically on UI-affecting tasks (with announcement)