qa-flow plugin
QA skills and agents: test-plan generation, manual test execution with recon and independent evidence review, a curated knowledge bank, bug filing, and promotion of strong scenarios to regression tests.
How to install the qa-flow plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add QAMarcos/claude-qa-flow
/plugin install qa-flow@qa-flowWhat's inside qa-flow
8 parts read from the plugin's own files.
Agents 2
Call as @agent-qa-flow:name- @agent-qa-flow:qa-evidence-revieweropus
Independently reviews a manual QA run — opens the screenshots, logs and scripts itself, attacks fragile PASS verdicts, finds missing coverage, and classifies each finding with the severity gate. Read-only; dispatched by the manual-test skill with a fresh context, never as a fork of the executor.
- @agent-qa-flow:qa-test-executorinherit
Executes an already-resolved manual QA plan against a running web app with a throwaway Playwright script, captures evidence, and returns a per-step PASS/FAIL report. Dispatched by the manual-test skill; never writes to the issue tracker and never asks the user questions.
Skills 5
Claude loads it when the task matches- create-test-plan-scenarios
Turn a task/ticket into a structured, professional QA test plan — a checklist of atomic, executable scenarios — and (optionally) post it back to your issue tracker. Use whenever the user asks to "create a test plan", "list test scenarios", "criar cenários de teste", "QA checklist for TICKET-XXXX", or otherwise wants a ticket turned into a verifiable QA plan. Works for any story type (UI, API, mobile, infra). Always runs a self-review pass before writing anything back.
- file-bug-ticket
File a bug (or feature/chore) ticket in your issue tracker via its REST API with a terse, budgeted description, attached screenshot evidence, owner/priority/placement filled in, and a verification GET before reporting done. Use whenever the user asks to "file a bug", "open a ticket", "criar um card", "abrir um bug", "report this to the tracker", or when manual-test hands over findings to file. Tracker-agnostic (Jira, Linear, GitHub Issues, Shortcut, ...).
- manual-test
Execute exploratory/manual QA against a web app, driven by either a ticket's test plan or a single ad-hoc scenario the user describes. Use whenever the user asks to "run a manual test", "fazer um teste manual", "execute this scenario", "validate this ticket manually", "manual test for TICKET-XXXX", or otherwise wants the agent to step through a behavior in the real app and report pass/fail with evidence. Resolves context with the user, delegates execution to an executor subagent, has the evidence checked by an independent reviewer, and only then (with approval) writes back to the tracker.
- promote-to-regression
Turn ONE reviewed manual QA run (a throwaway Playwright script + its report and evidence) into a committed regression spec in the project's e2e suite — only if the scenario is strong enough to earn a permanent place, rewritten in the suite's own conventions, proven stable and proven able to fail, and independently reviewed before anything is committed. Use whenever the user asks to "promote this test", "promover para regressão", "turn this manual test into an automated one", "add this scenario to the suite", "automatizar esse cenário", or picks a candidate from scan-regression-candidates. Never commits or opens a merge request without the user's explicit OK.
- scan-regression-candidates
Sweep a QA scratch root (default `_local/`, where manual-test keeps its throwaway scripts, evidence and logs) and list the few scenarios worth turning into committed regression tests — scored for value and cost, checked against the existing suite, with probes, one-offs and already-covered flows filtered out as noise. Read-only; produces a ranked backlog report and hands chosen candidates to promote-to-regression. Use whenever the user asks to "varrer a pasta local", "find regression candidates", "o que vale automatizar?", "which manual tests should become automated", "levantar testes pendentes de automação", or wants a backlog of automation from past manual runs.
Hooks 1
Runs on these events- PreToolUsecommand
Bash|PowerShell|Write|Edit|MultiEdit|NotebookEdit
Using qa-flow in Claude Code
Ask for an agent by name:
@agent-qa-flow:qa-evidence-reviewer
@agent-qa-flow:qa-test-executorSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update qa-flow@qa-flow
- Refresh the marketplace
- /plugin marketplace update qa-flow
- Turn it off for now
- /plugin disable qa-flow@qa-flow
- Remove it
- /plugin uninstall qa-flow@qa-flow
Skills in qa-flow
- manual-testQAMarcos/claude-qa-flow
Execute exploratory/manual QA against a web app, driven by either a ticket's test plan or a single ad-hoc scenario the user describes. Use whenever the user asks to "run a manual test", "fazer um teste manual", "execute this scenario", "validate this ticket manually", "manual test for TICKET-XXXX", or otherwise wants the agent to step through a behavior in the real app and report pass/fail with evidence. Resolves context with the user, delegates execution to an executor subagent, has the evidence checked by an independent reviewer, and only then (with approval) writes back to the tracker.
12 files12stars - promote-to-regressionQAMarcos/claude-qa-flow
Turn ONE reviewed manual QA run (a throwaway Playwright script + its report and evidence) into a committed regression spec in the project's e2e suite — only if the scenario is strong enough to earn a permanent place, rewritten in the suite's own conventions, proven stable and proven able to fail, and independently reviewed before anything is committed. Use whenever the user asks to "promote this test", "promover para regressão", "turn this manual test into an automated one", "add this scenario to the suite", "automatizar esse cenário", or picks a candidate from scan-regression-candidates. Never commits or opens a merge request without the user's explicit OK.
2 files12stars - scan-regression-candidatesQAMarcos/claude-qa-flow
Sweep a QA scratch root (default `_local/`, where manual-test keeps its throwaway scripts, evidence and logs) and list the few scenarios worth turning into committed regression tests — scored for value and cost, checked against the existing suite, with probes, one-offs and already-covered flows filtered out as noise. Read-only; produces a ranked backlog report and hands chosen candidates to promote-to-regression. Use whenever the user asks to "varrer a pasta local", "find regression candidates", "o que vale automatizar?", "which manual tests should become automated", "levantar testes pendentes de automação", or wants a backlog of automation from past manual runs.
2 files12stars - create-test-plan-scenariosQAMarcos/claude-qa-flow
Turn a task/ticket into a structured, professional QA test plan — a checklist of atomic, executable scenarios — and (optionally) post it back to your issue tracker. Use whenever the user asks to "create a test plan", "list test scenarios", "criar cenários de teste", "QA checklist for TICKET-XXXX", or otherwise wants a ticket turned into a verifiable QA plan. Works for any story type (UI, API, mobile, infra). Always runs a self-review pass before writing anything back.
12stars - file-bug-ticketQAMarcos/claude-qa-flow
File a bug (or feature/chore) ticket in your issue tracker via its REST API with a terse, budgeted description, attached screenshot evidence, owner/priority/placement filled in, and a verification GET before reporting done. Use whenever the user asks to "file a bug", "open a ticket", "criar um card", "abrir um bug", "report this to the tracker", or when manual-test hands over findings to file. Tracker-agnostic (Jira, Linear, GitHub Issues, Shortcut, ...).
12stars
qa-flow plugin questions
How do I install the qa-flow plugin?
In Claude Code run /plugin marketplace add QAMarcos/claude-qa-flow, then /plugin install qa-flow@qa-flow.
What does the qa-flow plugin include?
qa-flow bundles 2 agents, 5 skills, hooks.
Which agents come with qa-flow?
qa-evidence-reviewer, qa-test-executor. Call one with @agent-qa-flow:qa-evidence-reviewer.
How do I update or remove the qa-flow plugin?
Update it with claude plugin update qa-flow@qa-flow in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall qa-flow@qa-flow.
What license is the qa-flow plugin under?
MIT, as stated in the plugin's manifest.