systematic-debugging

Identify root causes of software bugs through observation, hypothesis testing, and verification.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/iclinic/afyapowers --skill systematic-debugging-iclinic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/iclinic/afyapowers/tree/main/src/skills/systematic-debugging
Command: npx skills add https://github.com/iclinic/afyapowers --skill systematic-debugging-iclinic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, data-driven approach to diagnosing and resolving software issues without guessing, ensuring root causes are identified before fixes.

Core Features & Use Cases

  • Stepwise root-cause investigation, pattern analysis, hypothesis testing, and safe implementation.
  • Applies to bugs, test failures, performance issues, and integration problems across software projects.
  • Use case: when facing a failure with unclear origin, follow the four phases to reproduce, instrument, and verify fixes.

Quick Start

Begin with Phase 1 by carefully observing the error, reproducing it reliably, and collecting evidence before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and when should I use it for troubleshooting software failures?

Systematic debugging is a disciplined, data-driven approach to identify the root cause of bugs before applying fixes. Use it when facing failures, test errors, or integration issues with unclear origins across complex software codebases.

How do I find the root cause of a bug with an unclear origin?

To find the root cause of a bug, follow a four-phase process: carefully observe and reproduce the error, analyze patterns, test hypotheses, and carefully implement fixes. This ensures root causes are identified through evidence before changes are applied.

What is the best way to debug test failures and performance issues without guessing?

The best way to debug test failures and performance issues without guessing is through evidence-based investigation. Instrument the code to collect data, verify fixes safely, and maintain traceability throughout the observation and hypothesis testing phases.

Can I apply systematic debugging to integration problems across complex codebases?

Yes, you can apply systematic debugging to integration problems across complex codebases. It guides engineers through pattern analysis and safe verification to improve software reliability regardless of the project's complexity or the integration failure's nature.

How do I start the root-cause investigation process when reproducing an error?

Begin root-cause investigation in Phase 1 by carefully observing the error and reproducing it reliably. Collect evidence and instrument the system before proposing or applying any fixes to ensure a data-driven debugging process.

Why should I trace bugs to the root cause before applying code fixes?

Tracing bugs to the root cause before applying fixes prevents recurring issues and unintended side effects. Evidence-based debugging with safe verification improves overall software reliability by ensuring the actual origin is resolved, not just the symptoms.