Test Debugger — Testing & QA agent for Claude Code
Takes a failing or flaky test to its cause through the Playwright test MCP server, fixes the test or writes the bug, proves the fix, and quarantines only a proven flake.
How to install Test Debugger
Installs to ~/.claude/agents/qoopi-agent-tests-playbook-test-debugger.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/qoopi/agent-tests-playbook/HEAD/agents/test-debugger.md -o ~/.claude/agents/qoopi-agent-tests-playbook-test-debugger.md Restart Claude Code, or start a new session, for it to be picked up.
What Test Debugger does
name: test-debugger description: Takes a failing or flaky test to its cause through the Playwright test MCP server, fixes the test or writes the bug, proves the fix, and quarantines only a proven flake. Started by the master session with the path of a brief file. color: red
test-debugger
You find out why a test is red and change only what the cause allows. Your prompt is the path of a brief. The brief is your whole scope.
Start, in this order
- Read the brief at the path in your
Alternatives in Testing & QA
- Debugger — Debugging specialist for errors, test failures, and unexpected behavior 2.8k ★
- Codex Debugger — Root-cause a failing test, crash, stack trace, or misbehaving feature by delegating the investigation to OpenA 249 ★
- Backend Expert — Use when a wizard run reaches implementation and needs the SERVER-SIDE turned GREEN against the architect's RE 71 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Rig Debugger
Systematic root-cause debugger. Use when investigating a failing test, a production bug, a flaky behavior, or
Swift Debugger
Root-cause analysis for Swift/iOS failures — compiler errors, test failures, crashes, data races, SwiftUI view
E2e Failure Classifier
Use when a Playwright or Cypress test failure needs a root cause, to classify ONE failure into the F1–F15 taxo
E2e Debugger
Use this agent for Playwright E2E test debugging — test failures, selectors, timeouts, authentication flows, c
05 Defect Triage.Agent
Defect classification and triage specialist. Takes raw failures from test execution and produces: severity/pri
Omelette Tester
Clean-context tester — takes the approved spec and the diff from git, writes tests, runs them through the real
Related Skills
Debug Blitz
Parallel debug assault — fires debug-detective + silent-failure-hunter + env-debugger simultaneously. Three ro
Debugging
Debug a bug, crash, failing test, or broken build to root cause
Root Cause Fix
Root-cause-first TDD loop for any bug or data fix. Forces a failing reproduction test BEFORE touching producti