ad-diagnose

Diagnose hard bugs and performance regressions through a phased hypothesis-testing workflow.

728|16|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-diagnose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-diagnose
Source: https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime/tree/main/.agents/skills/ad-diagnose
Command: npx skills add https://github.com/alexandremendoncaalvaro/CorridorKey-Runtime --skill ad-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined, end-to-end diagnosis loop to locate hard bugs and performance regressions by turning symptoms into a fast, verifiable remediation path.

Core Features & Use Cases

  • Structured diagnosis workflow that drives reproducibility, hypothesis generation (3–5 falsifiable hypotheses), instrumentation, and regression validation.
  • Phase-driven routing guidance for when to escalate to supporting techniques (ad-spike, ad-grill, ad-tdg) based on the uncertainty of approaches or the clarity of the spec.
  • Deterministic loop outputs including a captured failure symptom, ranked hypotheses, and a regression test plan to land with commits.

Quick Start

Initiate the diagnose workflow on a failing build to begin the disciplined loop.

Frequently Asked Questions about ad-diagnose

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

FAQPage Schema
How do I debug hard bugs and performance regressions when the cause is unclear?

To debug flaky tests and unclear regressions, use a structured diagnosis workflow that builds a feedback loop, reproduces the failure, generates ranked falsifiable hypotheses, instruments the code, and validates the fix with regression tests.

What is a disciplined debugging workflow for fault localization?

Disciplined debugging for fault localization is a repeatable workflow that captures failure symptoms, ranks three to five falsifiable hypotheses, instruments the system for evidence, and outputs a verifiable resolution trace with a regression test plan.

How do I reproduce flaky test failures to verify a fix?

Reproducing flaky test failures requires building a structured feedback loop within the diagnosis phase to reliably trigger the symptom across tools and environments, which then enables accurate hypothesis generation and fault localization.

When should I use a structured hypothesis testing approach for diagnosing regressions?

Use structured hypothesis testing for diagnosing regressions when causes are unclear, tests are flaky, or fault localization requires systematic verification across multiple tools and environments to ensure reproducibility and a verifiable resolution trace.

How do I generate falsifiable hypotheses for software debugging?

Generating falsifiable hypotheses for software debugging involves ranking three to five potential causes during the diagnosis loop, then systematically validating or eliminating them through targeted code instrumentation and feedback loops to isolate the exact fault.

What is the best way to ensure reproducibility when fixing hard bugs?

To ensure reproducibility when fixing hard bugs, follow a deterministic diagnosis loop that captures the failure symptom, ranks hypotheses, and produces a regression test plan, yielding a verifiable resolution trace to commit alongside the fix.