claude-code20 minintermediateverified: claude-fable-5, 2026-07
SOP: Close the loop — code change → live browser → screenshot proof
When done, "it works" means a screenshot of it working, produced by the agent
itself. 20 minutes; needs Claude Code with the browser tools (built-in Browser
pane or Chrome extension).
Before you start
- [ ] A web project with a dev server command (
npm run devor similar). - [ ] Browser tools respond: ask Claude "take a screenshot of the browser
pane" once a page is open.
Steps
- Teach the launch. Add
.claude/launch.jsonwith your dev-server - Add the verification contract to CLAUDE.md:
- Test it. Ask for a visible change ("make the header background blue").
- Wire it into reviews. If you use a reviewer subagent (ship-team), add:
config (name, command, port) so the agent starts the app the same way
every time.
✓ Check: "start the dev server and open the app" works in one message.
`
Any change affecting the UI is unfinished until verified in the browser:
navigate to the affected screen, exercise the change, screenshot it, and
check the console for new errors. Save evidence to verify/<date>-<change>.png.
The claim "done" requires the screenshot path.
`
✓ Check: contract sits near the top of CLAUDE.md.
✓ Check: agent edits → reloads → screenshots → the file exists and shows
blue; console errors reported (or "none").
"For UI changes, demand the screenshot; a UI diff without evidence is FIX."
✓ Check: a UI change without a screenshot gets bounced.
Verify the whole thing
One real feature end-to-end: the final report should contain the change
summary, the screenshot path, and console status — without you asking.
Rollback
Remove the contract from CLAUDE.md; delete verify/.
When it breaks
| Symptom | Cause | Fix |
|---|---|---|
| Agent claims done, no screenshot | contract phrased as suggestion | use the exact "unfinished until" wording — it's a definition, not advice |
| Screenshots of the wrong page | no route named in the task | name the affected route in the contract: "the affected screen" = URL |
| Console noise drowns real errors | pre-existing warnings | baseline once: "log current console warnings to verify/baseline.txt", compare against it |
Changelog
- 0.1.0 (2026-07-04) — initial, verified on Claude Fable 5.
One email when a pack ships or gets re-benchmarked on a new model. No noise.