parallel-debugging

Diagnose complex bugs using competing hypotheses with parallel investigation and evidence-based arbitration.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/SanketAdlak/PDMProjectDesign --skill parallel-debugging-sanketadlak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-debugging
Source: https://github.com/SanketAdlak/PDMProjectDesign/tree/main/.agents/skills/parallel-debugging
Command: npx skills add https://github.com/SanketAdlak/PDMProjectDesign --skill parallel-debugging-sanketadlak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging issues with multiple plausible root causes often leads to confirmation bias and wasted effort chasing a single theory. This Skill structures root cause analysis using the Analysis of Competing Hypotheses (ACH) methodology, coordinating parallel investigations with rigorous evidence standards. ## Core Features & Use Cases - Hypothesis Generation Framework: Systematically generates hypotheses across six failure mode categories: logic errors, data issues, state problems, integration failures, resource issues, and environment differences. - Evidence Collection Standards: Classifies evidence by strength (direct, correlational, testimonial, absence) with mandatory file:line citations and calibrated confidence levels. - Result Arbitration Protocol: Categorizes findings as confirmed, plausible, falsified, or inconclusive, then ranks competing hypotheses to determine the root cause. - Use Case: When a production API intermittently returns 500 errors, spawn parallel investigations into handler exceptions, database connections, and environment variables, then arbitrate the evidence to identify the true root cause. ## Quick Start Use the parallel-debugging skill to investigate why the checkout endpoint intermittently fails by generating competing hypotheses and collecting evidence for each.

Frequently Asked Questions about parallel-debugging

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

FAQPage Schema
How do I debug a bug with multiple possible root causes?

Generate hypotheses across six failure mode categories (logic, data, state, integration, resource, environment), then investigate each in parallel. Collect evidence with file:line citations and use the arbitration protocol to confirm or falsify each hypothesis.

What is the Analysis of Competing Hypotheses method for debugging?

ACH is a structured root cause analysis technique that evaluates multiple hypotheses simultaneously rather than chasing one theory. It reduces confirmation bias by actively seeking falsifying evidence and ranking confirmed hypotheses by confidence and causal chain strength.

How do I avoid confirmation bias when debugging?

Define falsifying evidence criteria for each hypothesis before investigating, and assign parallel investigators to competing theories. Classify evidence by strength and require direct evidence with file:line citations before declaring a root cause.

When should I use parallel hypothesis investigation instead of step-through debugging?

Use it when a bug has multiple plausible causes, spans several modules, or resists initial debugging attempts. It is less suitable for simple, reproducible errors where a stack trace directly identifies the fault.

How do I determine root cause when multiple hypotheses are confirmed?

Rank confirmed hypotheses by confidence level, number of supporting evidence pieces, and causal chain strength. If equally strong and related, treat it as a compound issue with multiple contributing causes; otherwise declare the highest-ranked as primary.