systematic-debugging

Enforce root-cause analysis before code fixes using a four-phase debugging workflow.

146|35|Updated Mar 20, 2023
One-click install
npx skills add https://github.com/mwangli/stock-trading --skill systematic-debugging-mwangli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/mwangli/stock-trading/tree/main/.trae/skills/systematic-debugging
Command: npx skills add https://github.com/mwangli/stock-trading --skill systematic-debugging-mwangli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new issues. Systematic debugging ensures root causes are found before applying any fix, improving stability and time-to-resolution.

Core Features & Use Cases

  • Phase-driven workflow spanning Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Comprehensive evidence gathering across components and logs to locate the true source of failures.
  • Safe fix practices including creating failing tests and validating fixes before declaring success.

Quick Start

Begin with Phase 1: reproduce the issue and collect diagnostic evidence, then progress through Phases 2–4 to implement a root-cause based fix.

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 production bug before applying a fix?

To find the root cause of a production bug, you must enforce a systematic debugging workflow that reproduces the issue and gathers diagnostic evidence across components before writing any code fix.

What is the best way to troubleshoot recurring test failures systematically?

Troubleshooting test failures systematically requires a four-phase workflow: root-cause investigation, pattern analysis, hypothesis testing, and implementation with explicit evidence gathering to locate the true source of failures.

How do I stop random fixes from creating new issues in my software?

Stop random fixes by enforcing root-cause analysis before any code modification, ensuring you create failing tests and validate fixes before declaring success to improve system stability.

Can I use systematic debugging for performance issues and integration problems?

Yes, systematic debugging applies to performance issues and integration problems by driving a phase-based workflow that requires explicit evidence gathering and hypothesis verification across software systems.

What are the steps to diagnose software errors systematically?

Diagnosing software errors systematically involves four phases: reproduce the issue and collect diagnostic evidence, analyze patterns, test hypotheses, and implement a root-cause based fix with verification.

When should I not use a phase-based debugging approach?

Avoid phase-based debugging only for trivial, immediately obvious errors where the root cause is already explicitly identified, as the evidence gathering and hypothesis testing workflow adds unnecessary overhead.