Bug Hypothesis Investigator — Testing & QA agent for Claude Code
Use when one candidate cause of a defect needs a falsifiable test before anyone believes it.
How to install Bug Hypothesis Investigator
Installs to ~/.claude/agents/joey114132-claude-agent-teams-bug-hypothesis-investigator.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/joey114132/claude-agent-teams/HEAD/agents/bug-hypothesis-investigator.md -o ~/.claude/agents/joey114132-claude-agent-teams-bug-hypothesis-investigator.md Restart Claude Code, or start a new session, for it to be picked up.
What Bug Hypothesis Investigator does
name: bug-hypothesis-investigator description: Use when one candidate cause of a defect needs a falsifiable test before anyone believes it. Give it the symptom, the repro or logs, the decision-record paths and exactly one hypothesis. It states a prediction that would prove the hypothesis wrong, runs the cheapest read-only experiment, and returns the verbatim observation. It also has an enumerate mode (propose distinct hypotheses plus one decoy that the evidence already rules out) and a re-in
Alternatives in Testing & QA
- Prod Incident Responder — Reads recent prod logs, picks the highest-impact recurring error, drafts a minimal fix PR with a regression te 324 ★
- Unit Executor — Implements exactly one unit of work from an inline spec and returns a structured JSON record 314 ★
- Critical Thinking — Critical thinking mode that challenges assumptions and probes reasoning 100 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Flake Investigator
Establishes why a Playwright case failed intermittently and classifies the cause before anyone changes the tes
Duel Fix Builder
Use when one established cause of a defect has a failing repro test and needs the smallest fix that makes that
QA Incident Investigator
Correlates prepared logs, traces, batch results, API observations, and restricted data evidence without mutati
Opus Agent
Tier opus worker. Work carrying a decision — rule or spec prose that states a rule, an exported signature or m
Bayes Scorer
Use this agent when a /bayes decision needs evidence gathered from files, logs, git history or test output bef
06 Release Readiness.Agent
Release gate decision agent. Consumes all QA pipeline outputs (plan, execution results, defect triage, metrics
Related Skills
Diagnose Bug
Diagnose the root cause of a bug -- evidence, minimal repro, one hypothesis at a time
Project Debug
Hypothesis-driven troubleshooting: structured debug from symptom to root cause
Investigator
Root-cause debugging specialist that diagnoses issues through systematic investigation before proposing any fi