systematic-debugging

Investigate software defects by mandating root cause analysis before implementing fixes.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Luizfbm/Dev-roast --skill systematic-debugging-luizfbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Luizfbm/Dev-roast/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/Luizfbm/Dev-roast --skill systematic-debugging-luizfbm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill prevents the common trap of applying random, ineffective patches to symptoms, which often leads to technical debt and new bugs. It enforces a disciplined, scientific approach to debugging that saves time by ensuring the actual root cause is identified and resolved.

Core Features & Use Cases

  • Root Cause Mandate: Forces a structured investigation process before any code changes are proposed.
  • Defense-in-Depth: Provides patterns for adding multi-layer validation to make bugs structurally impossible.
  • Flaky Test Resolution: Includes specific techniques for replacing arbitrary timeouts with reliable condition-based waiting.
  • Use Case: When a production service experiences intermittent failures, use this skill to trace the data flow backward from the error, identify the original trigger, and implement robust validation at every layer of the system.

Quick Start

Load the systematic-debugging skill and follow the four-phase framework to investigate the current test failure.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of flaky test failures instead of patching symptoms?

To find the root cause of flaky test failures, you must enforce a structured investigation process that replaces arbitrary timeouts with reliable condition-based waiting. This ensures you identify the actual trigger before proposing any code changes.

What is the best way to debug intermittent production failures in multi-component architectures?

The best way to debug intermittent production failures is to trace the data flow backward from the error. This systematic approach identifies the original trigger across multi-component architectures and implements robust validation at every system layer.

Why does symptom-based debugging lead to technical debt and new bugs?

Symptom-based debugging leads to technical debt because it applies random, ineffective patches to symptoms rather than resolving the actual root cause. A disciplined, scientific approach ensures the original trigger is identified and resolved.

Step by step, how do I apply a root cause investigation framework to software defects?

You apply root cause investigation by following a four-phase framework that mandates evidence gathering, hypothesis testing, and architectural validation. This prevents symptom-based patching and ensures the actual trigger is resolved before implementation.

Can I use systematic debugging to prevent bugs structurally instead of just fixing them?

Yes, you can prevent bugs structurally by applying defense-in-depth patterns. This involves adding multi-layer validation to make specific bugs structurally impossible across your system, moving beyond simple fixes to architectural validation.

Does this debugging approach work without adding new dependencies to my project?

Yes, this debugging approach works without adding new dependencies. It relies on a rigorous framework for evidence gathering, hypothesis testing, and architectural validation to systematically identify and resolve software defects.