qa-runner

QA Runner

Executes structured QA checklists against a running app using Browser Bridge MCP tools. Reads a checklist markdown file with YAML frontmatter and CSS selectors, drives the browser through each scenario, captures evidence (screenshots, console logs, content checks), and reports pass/fail results.

When to Use

• User says "run QA" or "qa check"
• User says "test checklist" or "run checklist"
• User wants to execute a QA checklist against a live app

When NOT to Use

• Running unit tests or E2E test suites (use the project's test runner)
• Writing new tests

Prerequisites Check

Before running any scenario, verify ALL of these:

digraph prereqs {
  "Start" [shape=doublecircle];
  "browser_status?" [shape=diamond];
  "Extension connected" [shape=box];
  "STOP: Tell user to load extension" [shape=box, style=filled, fillcolor="#ffcccc"];
  "App running?" [shape=diamond];
  "Navigate to app_url" [shape=box];
  "STOP: Tell user to start dev server" [shape=box, style=filled, fillcolor="#ffcccc"];
  "Checklist exists?" [shape=diamond];
  "Parse and execute" [shape=box];
  "STOP: Checklist not found" [shape=box, style=filled, fillcolor="#ffcccc"];

  "Start" -> "browser_status?";
  "browser_status?" -> "Extension connected" [label="connected: true"];
  "browser_status?" -> "STOP: Tell user to load extension" [label="connected: false"];
  "Extension connected" -> "App running?";
  "App running?" -> "Navigate to app_url" [label="yes"];
  "App running?" -> "STOP: Tell user to start dev server" [label="no"];
  "Navigate to app_url" -> "Checklist exists?";
  "Checklist exists?" -> "Parse and execute" [label="yes"];
  "Checklist exists?" -> "STOP: Checklist not found" [label="no"];
}

Step 1: Check browser connection

Call browser_status. If connected: false, stop and tell the user:

Chrome extension is not connected. Please:

1. Open chrome://extensions and ensure "Browser Bridge MCP" is enabled
2. Click the extension icon and verify it shows "Connected"
3. If disconnected, click "Reconnect"