/qa-use:verify-pr

Verify a pull request's frontend changes through automated browser testing.

Invokes skill: qa-use

Arguments

Argument	Description
`pr`	PR number (e.g., `#123`), URL, or omit to infer from current branch
`--base-url <url>`	Override base URL for ephemeral/preview deployments

What Happens

Spawns a single pr-verifier agent in the background
Agent analyzes the PR, identifies changed routes
Agent creates ONE browser session and verifies all features sequentially
Agent generates a concise visual report with inline screenshots
Report saved to /tmp/pr-verify-report-<pr>.md

You can continue working while verification runs in the background.

Examples

/qa-use:verify-pr #123
/qa-use:verify-pr https://github.com/owner/repo/pull/123
/qa-use:verify-pr                              # infer from current branch
/qa-use:verify-pr #123 --base-url https://preview-123.example.com

Workflow

Step 1: Parse Arguments

Extract from arguments:

pr: PR number/URL or empty (agent will infer from branch)
base_url: Optional URL override from --base-url flag

Step 2: Detect Environment

Check if running in CI:

# CI environment detected if either is "true"
echo $CI
echo $GITHUB_ACTIONS

Step 3: Spawn PR-Verifier Agent

In CI (CI=true or GITHUB_ACTIONS=true): Run synchronously and wait for completion.

Task(
  subagent_type: "qa-use:pr-verifier",
  run_in_background: false,  # MUST wait in CI
  prompt: "Verify PR <pr> with base_url=<base_url>"
)

Locally (interactive): Run in background so user can continue working.

Task(
  subagent_type: "qa-use:pr-verifier",
  run_in_background: true,
  prompt: "Verify PR <pr> with base_url=<base_url>"
)

Step 4: Output

In CI: Wait for agent to complete, then output the report path and suggest posting to PR.

Locally: Return immediately with:

🚀 PR verification started in background.
   Report will be at: /tmp/pr-verify-report-<pr>.md
   To post: gh pr comment <pr> --body-file /tmp/pr-verify-report-<pr>.md

Report Format

The agent generates a concise visual report:

## PR #123 Verification

**Branch**: `feature-branch` | **Verified**: 2024-01-25 14:30

### Summary
✅ 2 features verified | ⚠️ 1 issue found

---

### /autocomplete ✅
[Session](app_url) | [Recording](recording_url)

![Search results showing engineers](screenshot_url)

- Search returns results with debounce
- Multi-select chips work

---

### /home ⚠️
[Session](app_url) | [Recording](recording_url)

![Slow load visible](screenshot_url)

- Navigation link visible
- ⚠️ Slow load time (3s)

Prerequisites

qa-use CLI configured: API key set via QA_USE_API_KEY or ~/.qa-use.json
GitHub CLI (gh) available: For PR context
App accessible: Running locally or via preview URL

CI Integration

See references/ci.md for GitHub Actions setup.

Verify Pr