Skip to content

feat(qa-changes): capture visual evidence for frontend PRs#403

Open
smolpaws wants to merge 1 commit into
OpenHands:mainfrom
smolpaws:qa-visual-evidence
Open

feat(qa-changes): capture visual evidence for frontend PRs#403
smolpaws wants to merge 1 commit into
OpenHands:mainfrom
smolpaws:qa-visual-evidence

Conversation

@smolpaws

Copy link
Copy Markdown
Contributor

What

Add a step to the qa-changes skill: capture visual evidence for frontend PRs.

If the PR has frontend work, QA should run the affected screens from the branch's final state and record what a reviewer would otherwise have to imagine from the diff — so the change can be reviewed by observation, not by reading code.

The step

For frontend PRs, after exercising the UI:

  1. Screenshot each relevant state of every affected screen — empty, loading, error, populated (whichever apply).
  2. Record a GIF (or short video) of the key interaction end to end — the main flow the PR changes, driven as a user would.
  3. Where behavior changes, capture before/after — same state/interaction on base vs PR branch.
  4. Attach it all to the PR — embed inline in the QA report; if the environment can't upload through the API, commit the media under .pr/ and reference the raw URLs. Label each clearly.

Kept proportional (only the screens the PR touches) with an explicit "say so if you can't render a screen" escape hatch — consistent with the skill's existing "give up gracefully / report honestly" ethos.

Changes

  • skills/qa-changes/SKILL.md: new "Capture visual evidence" step in Phase 3, a "Visual Evidence" collapsible in the report format, and a matching key principle.
  • skills/index.js: regenerated skills catalog (node scripts/build-skills-catalog.mjs).

Docs-only change to a skill; no code paths affected.

@github-actions github-actions Bot added the type: feat A new feature label Jul 11, 2026
Add a Phase 3 step: when a PR has frontend work, run the affected screens
from the branch's final state and capture a screenshot of each relevant
state (empty, loading, error, populated) plus a GIF of the key interaction
end to end. Where behavior changes, include before/after. Attach it all to
the PR so the change can be reviewed by observation, not by reading the diff.

Adds a matching 'Visual Evidence' block to the report format and a key
principle, and regenerates the skills catalog.

Co-authored-by: smolpaws <engel@enyst.org>
@smolpaws smolpaws force-pushed the qa-visual-evidence branch from 4f0b766 to 5f35ee0 Compare July 11, 2026 01:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: feat A new feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants