systematic-debugging

Guide engineers through a four-phase workflow to isolate root causes of bugs.

27|2|Updated Jan 15, 2024
One-click install
npx skills add https://github.com/erfanzar/Xerxes-Agents --skill systematic-debugging-erfanzar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/erfanzar/Xerxes-Agents/tree/main/src/python/xerxes/skills/systematic-debugging
Command: npx skills add https://github.com/erfanzar/Xerxes-Agents --skill systematic-debugging-erfanzar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, four-phase framework to diagnose and understand bugs before attempting fixes, reducing blind patches and rework.

Core Features & Use Cases

  • Phase-based investigation across error messages, reproduction, evidence gathering, and data-flow tracing.
  • Structured phases (Phase 1–4) guiding root-cause analysis, pattern analysis, hypothesis testing, and safe implementation.
  • Prevents premature fixes by enforcing evidence-based decision making across software issues, tests, and deployments.

Quick Start

Begin Phase 1 by reading error messages, reproducing the issue, and gathering 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
How do I systematically debug a production service failure?

Systematic debugging isolates root causes of production service failures through a four-phase workflow: error analysis, pattern comparison, hypothesis testing, and careful implementation. It enforces evidence gathering before proposing any fixes to ensure safe, verifiable resolutions.

What is the best way to find the root cause of failing CI pipelines?

The best way to find the root cause of failing CI pipelines is a structured investigation that reads error messages, reproduces the issue, and traces data-flow. This prevents premature fixes by enforcing evidence-based decision making across deployment environments.

Can I use this systematic debugging approach for test failures and integration faults?

Yes, you can use systematic debugging for test failures and integration faults. The four-phase framework applies to any technical issue across codebases, CI pipelines, prod services, and deployment environments, including performance problems and integration faults.

How do I start Phase 1 of root-cause analysis for codebase bugs?

To start Phase 1 of root-cause analysis for codebase bugs, begin by reading error messages, reproducing the issue, and gathering evidence before proposing any fixes. This initial investigation prevents blind patches and reduces rework.

Why does troubleshooting complex issues often lead to rework and blind patches?

Troubleshooting complex issues leads to rework and blind patches when engineers attempt premature fixes without understanding the root cause. A disciplined, four-phase framework enforces evidence-based decision making to diagnose and understand bugs before implementation.