parallel-debugging

Orchestrate parallel debugging investigations using the Analysis of Competing Hypotheses methodology.

6|2|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/acaprino/claude-code-daodan --skill parallel-debugging-acaprino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parallel-debugging
Source: https://github.com/acaprino/claude-code-daodan/tree/main/plugins/agent-teams/skills/parallel-debugging
Command: npx skills add https://github.com/acaprino/claude-code-daodan --skill parallel-debugging-acaprino

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Debug complex software issues by structuring parallel investigations, evidence collection, and root cause arbitration using the Analysis of Competing Hypotheses (ACH) framework.

Core Features & Use Cases

  • Hypothesis-driven debugging: Generate and test multiple hypotheses in parallel across modules or services.
  • Evidence-based arbitration: Collect, organize, and cite evidence to support conclusions.
  • Agent-based orchestration: Deploy specialized investigators to focus on distinct failure modes (logic, data, state, integration, resource, environment) and coordinate results.
  • Use Case: When a bug spans multiple components, run parallel investigations to pinpoint the root cause and verify the fix end-to-end.

Quick Start

Provide an ACH-based investigation plan for a failing multi-module feature.

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 distributed system bug with multiple plausible root causes?

Debug distributed system bugs by applying the Analysis of Competing Hypotheses (ACH) methodology to generate multiple hypotheses and orchestrate parallel investigations across modules. This coordinates specialized agents to collect evidence and arbitrate root causes efficiently.

What is the Analysis of Competing Hypotheses methodology for software debugging?

The Analysis of Competing Hypotheses (ACH) is a structured debugging methodology that generates multiple hypotheses, runs parallel evidence collection across components, and cross-references findings to arbitrate the true root cause of complex multi-module failures.

How do I coordinate parallel investigations across different failure modes?

Coordinate parallel investigations by deploying specialized agents to focus on distinct failure modes like logic, data, state, integration, resource, and environment. The ACH framework structures their evidence collection and ensures clear exit criteria for arbitration.

Can I use structured hypothesis generation for multi-component service failures?

Yes, structured hypothesis generation is designed for multi-module or distributed system bugs where several root causes are plausible. It requires generating hypotheses, collecting cited evidence across domains, and coordinating specialized investigators to pinpoint the failure.

When should I use parallel debugging instead of standard troubleshooting?

Use parallel debugging when a bug spans multiple components and several root causes are plausible. If evidence must be collected across modules or services and standard linear troubleshooting fails to pinpoint the failure, ACH-based orchestration fast-tracks root cause arbitration.

What are the limitations of agent-based orchestration for root cause analysis?

Agent-based orchestration requires structured hypothesis generation upfront and depends on clear exit criteria for arbitration. Without specialized investigators assigned to distinct failure modes and proper evidence collection, the parallel debugging process cannot effectively converge on a root cause.