Diagnose

Reproduce software bugs and generate ranked falsifiable hypotheses.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/anderson-joyle/claude-a-team --skill diagnose-anderson-joyle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Diagnose
Source: https://github.com/anderson-joyle/claude-a-team/tree/main/skills/diagnose
Command: npx skills add https://github.com/anderson-joyle/claude-a-team --skill diagnose-anderson-joyle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you turn an unclear bug report into a deterministic debugging starting point by building a feedback loop, reproducing the failure, and generating falsifiable hypotheses before any implementation changes.

Core Features & Use Cases

  • Diagnosis Probe feedback loop: Selects an appropriate repro strategy (tests, curl/HTTP, CLI snapshots, headless browser, trace replay, minimal harness, fuzzing, bisecting, differential runs, or HITL script) and drives it until you have a reliable signal.
  • Reproduction confirmation gate: Verifies that the loop reproduces the user-described failure, is repeatable (or debuggable at a high enough rate for flaky bugs), and captures the exact symptom needed for later verification.
  • Ranked falsifiable hypotheses: Produces 3–5 prioritized, testable cause-and-effect statements with explicit predictions to guide Phase 2.

Quick Start

Use this skill when you have a bug (work_type set to bug) and ask an AI to produce a reproducible diagnosis probe and a set of ranked, falsifiable hypotheses based on the evidence it gathered.

Frequently Asked Questions about Diagnose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reproduce a software bug from an unclear report before writing code?

To reproduce a software bug, you can build a deterministic feedback loop using tests, curl/HTTP, CLI snapshots, headless browsers, or trace replay until you get a reliable, repeatable signal confirming the reported failure.

What is a falsifiable hypothesis in debugging and how does it help diagnose bugs?

A falsifiable hypothesis in debugging is a prioritized, testable cause-and-effect statement with explicit predictions. It guides your diagnosis by verifying or eliminating suspected causes through probe-gated execution before implementation.

How do I create a test harness for reproducing flaky bugs that are not consistently repeatable?

You create a test harness by selecting a repro strategy like fuzzing or bisecting and driving it until the loop is debuggable at a high enough rate for flaky bugs, capturing the exact symptom needed for later verification.

What's the best way to diagnose software bugs without directly modifying production code?

The best way to diagnose bugs without production changes is to create a diagnosis probe using available test, API, UI, trace, or harness techniques to gather evidence and generate ranked hypotheses for subsequent execution.

Can I use trace replay and differential runs to verify a bug reproduction?

Yes, you can use trace replay and differential runs as repro strategies to drive a deterministic feedback loop, verifying that the loop reproduces the user-described failure and captures the exact symptom for verification.

When should I not use a diagnosis probe approach for debugging?

You should not use a diagnosis probe approach if your work type is not a bug, or if you cannot establish a repeatable feedback loop, as the method requires symptom capture and repeatability checks to generate falsifiable hypotheses.