agent-qa Browser Regression (Spring Boot 3)
A disciplined workflow for verifying browser user journeys of a running Spring Boot 3 app with the agent-qa CLI, reporting only evidence from real runs.
Dev & CodingAdvanced★ 338⑂ 54AI score 8/10Last updated: Nov 2, 2026
What it does
- Gives Claude the procedure and guardrails for running browser-based regression checks with the
agent-qaCLI against a live Spring Boot 3 application. - Enforces four phases: target selection (distinguishing the real UI origin from a reverse proxy, API port, or Actuator management port), scoped execution (validate → dry-run → live run only when authorized), run evidence (run ID, digest, runs overview, per-step evidence), and memidex provenance.
- Protects the testing pyramid: browser coverage must not replace MockMvc, repository tests, or Testcontainers.
- Preserves authentication, authorization, CSRF, tenant boundaries, and response envelopes — disabling security to make a test pass is explicitly forbidden.
- Keeps credentials in
workspace.secretsFilereferenced as{{secret:NAME}}, and warns that text masking does not cover screenshots or video artifacts. - Refuses to report a dry run or exit code 0 as a pass; requires the actual native verdict text and reports inability to execute as a separate limitation.
Who it's for
- Teams running a Spring Boot 3 app with a real browser UI who have adopted (or are evaluating) agent-qa's natural-language tests.
- QA and backend engineers who have been burned by an AI claiming "tests passed" when it only hit a health endpoint.
- Tech leads who want to pre-empt agents stripping CSRF or auth after a 403.
- Not a fit for API-only services — the skill itself redirects those to HTTP/integration testing skills.
Usage examples
- Checkout flow regression: "Verify the checkout journey on the new build" → review
tests/checkout.yaml, runagent-qa validate, then--dry-run, and only with authorizationagent-qa run tests/checkout.yaml --build-tag "$APP_BUILD_TAG", then read the digest and step evidence for the report. - Failure triage: When a run fails, separate an application defect from a wrong test expectation, an environment failure (missing credentials or infrastructure), or an uncertain agent verdict — and propose the smallest next action.
- Memory cross-check: When an old memidex success conflicts with a current failure, use
agent-qa runs knowledge RUN_ID --jsonandknowledge inspectto check provenance and current validity, without accepting, rejecting, or forgetting records during review.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/rrezartprebreza/spring-boot-skills/HEAD/skills/spring-boot-3/agent-qa-browser-regression/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on AI Skill Mart. Copy the skills/spring-boot-3/agent-qa-browser-regression folder from the GitHub repo rrezartprebreza/spring-boot-skills into my ~/.claude/skills/agent-qa-browser-regression/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/rrezartprebreza/spring-boot-skills.git && mkdir -p ~/.claude/skills && cp -r spring-boot-skills/skills/spring-boot-3/agent-qa-browser-regression ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and move to the folder where you keep skills.
- Clone the repository:
git clone https://github.com/rrezartprebreza/spring-boot-skills.git - Create the Claude skills directory:
mkdir -p ~/.claude/skills - Copy the whole skill folder so the bundled
examples/files come along:cp -r spring-boot-skills/skills/spring-boot-3/agent-qa-browser-regression ~/.claude/skills/ - Optionally copy the referenced companion skill so internal links resolve:
cp -r spring-boot-skills/skills/spring-boot-3/testing-pyramid ~/.claude/skills/ - Prepare prerequisites: install Node.js 24+, install the
agent-qaCLI, and set upagent-qa.config.yamlplusworkspace.secretsFilein your project directory. - Restart Claude Code, then ask something like "Use agent-qa to verify the checkout journey on the running app."
- Always rehearse against a disposable test environment first; live or production runs require explicit authorization and the documented configuration gate.
View source on GitHub ↗License: MIT