Repository navigation
feat(browser-qa): add before/after screenshot QA topic - #11
Merged
Merged
Conversation
Tell agents to verify user-visible UI changes in a real browser, capture before/after screenshots, and attach them to the GitHub PR, GitHub Issue, or Jira ticket that tracks the work. Phrased as generic browser automation so Codex can follow it too. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…capture Screenshots cannot show that a click did nothing, so interaction bugs get a scripted before/after video pair: frames captured per step, the target highlighted before each click, two-line captions carrying the action and the live page state, a BEFORE/AFTER tag on every frame, assembled with ImageMagick and ffmpeg. Prefer the cmux browser CLI for driving and capturing, and claude-in-chrome for attaching the evidence to GitHub (it holds the user's signed-in session). Attachment notes cover GitHub's comment-box upload and Jira's [^name] references. Also add a "Where to capture" section: try the local dev stack first for both halves of the pair and fall back to staging or production only when local cannot reproduce the state. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
gsdevme
force-pushed
the
feat/browser-qa
branch
from
October 29, 2026 11:22
b74ecbc to
76ff35e
Compare
gsdevme
marked this pull request as ready for review
October 29, 2026 12:34
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a
browser-qa.mdtopic telling agents to QA user-visible UI changes in a real browser and attach before/after screenshots to the tracking artefact.<area>-before.png/<area>-after.png; keep them out of the working tree; cover default, loading/empty/error, and mobile width where relevant.Second commit extends the topic after using it on a real ticket (a chart timeframe bug where a click did nothing):
[^name]from the comment.The topic is registered in the Makefile
TOPIC_FILESlist (appended aftercode-comments.md), the README layout tree, and the three explicit enumerations intests/apply.bats.Test plan
make test— all 13 Bats tests passmake apply—~/.claude/CLAUDE.mdimportsbrowser-qa.mdand.agents/AGENTS.mdcontains the topic text🤖 Generated with Claude Code