Have Your Agent Ship Annotated Before/After Screenshot Sheets for UI Reviews
EdHinchliffe · x · 2026-11-18
Ed Hinchliffe shares a practical trick for reviewing agent-produced UI changes: ask the agent for an annotated before/after contact sheet instead of walls of markdown text — which he argues is the highest information-bandwidth review format.
The attached screenshot documents a fully reproducible workflow:
- Capture: create two worktrees (main + branch) via git worktree add --detach, build each with bun install && bun run build; reuse the feature's browser journey from integration tests into a temp zzPShots.integration.test.ts to capture screenshots into pre-shots/after-shots folders at a 1440x1000 viewport; run bun test --timeout 300000 in both trees (needs TESTDATABASEURL); clean up with git worktree remove --force.
- Annotate: use hand-drawn rough.js margin notes in the gutter between columns, never covering the UI; use brackets/underlines when a note's referent is ambiguous, and draw leader lines from notes to marks.
His broader point: making LLM-generated artifacts visually understandable — not more mermaid diagrams or markdown — is what actually speeds up teams and builds trust.