systematic-debugging

Guide root-cause debugging through a four-phase investigation workflow.

2|Updated Nov 21, 2025
One-click install
npx skills add https://github.com/maxjuniorbr/segflow-crm --skill systematic-debugging-maxjuniorbr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/maxjuniorbr/segflow-crm/tree/main/.cursor/skills/systematic-debugging
Command: npx skills add https://github.com/maxjuniorbr/segflow-crm --skill systematic-debugging-maxjuniorbr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Fornece um método estruturado para investigação e correção de problemas. Use ao se deparar com qualquer bug, falha de teste ou comportamento inesperado, antes de propor correções.

Core Features & Use Cases

  • Four-phase approach: investigate root cause, analyze patterns, form hypotheses, and implement fixes with validation.
  • Emphasis on evidence gathering, data flow tracing, and safe, incremental changes to avoid regression.
  • Real-world guidance for debugging bugs, test failures, performance issues, and integration problems.

Quick Start

Inicie a Fase 1: investigue a causa raiz, registre evidências e reproduza o problema antes de propor correções.

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 a bug systematically instead of guessing?

Systematic root-cause debugging requires investigating evidence, reproducing the problem, and tracing data flow before proposing fixes. You must gather concrete data and analyze patterns to pinpoint the actual origin of the issue rather than applying speculative patches.

What is the best way to troubleshoot a production incident without causing regressions?

Troubleshooting a production incident safely involves forming hypotheses based on evidence and implementing fixes incrementally. This methodical approach validates changes at each step, preventing regressions and ensuring system stability during emergencies.

Can I use a structured debugging methodology for test failures and performance issues?

Yes, a structured debugging methodology applies directly to test failures, performance issues, and integration problems. It guides investigators through a four-phase workflow of root-cause discovery, pattern analysis, hypothesis testing, and implementation regardless of the specific failure type.

How do I start a root-cause investigation when facing unexpected software behavior?

To start a root-cause investigation for unexpected software behavior, begin with Phase 1: investigate the root cause, record all evidence, and reliably reproduce the problem. This foundation is required before moving to pattern analysis or proposing corrections.

What techniques are involved in systematic software debugging?

Systematic software debugging involves techniques like root-cause tracing, defense in depth, and condition-based waiting. These methods enforce evidence gathering and hypothesis testing to resolve bugs, integration problems, and unexpected behavior across various environments.