systematic-debugging

Enforce a four-phase framework to identify root causes before implementing fixes.

5|1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/ed3dai/ed3d-plugins-testing --skill systematic-debugging-ed3dai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/ed3dai/ed3d-plugins-testing/tree/main/plugins/ed3d-plan-and-execute/skills/systematic-debugging
Command: npx skills add https://github.com/ed3dai/ed3d-plugins-testing --skill systematic-debugging-ed3dai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined framework to uncover root causes before applying fixes, reducing rework and rushed decisions.

Core Features & Use Cases

  • Enforces four phases: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, Implementation
  • Prevents shortcut fixes under pressure
  • Useful for any bug, test failure, or unexpected behavior in development, testing, or production

Quick Start

Load the skill: skills/debugging/systematic-debugging Read the overview and Phase 1 requirements Follow Phase 1 checklist to begin root-cause analysis If tempted to skip, review Phase 4 anti-pattern guidance Complete Phases 2-4 to confirm root cause before implementing 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 do I need it for software issues?

Systematic debugging is a disciplined four-phase framework to uncover root causes before applying fixes. You need it for any bug, test failure, or unexpected behavior in development, testing, or production to reduce rushed decisions and rework.

How do I find the root cause of a bug before implementing a fix?

To find the root cause of a bug, follow a structured process: investigate root causes in Phase 1, analyze patterns in Phase 2, test hypotheses in Phase 3, and implement fixes in Phase 4. This prevents shortcut fixes under pressure.

What's the best way to stop applying shortcut fixes under production pressure?

The best way to stop applying shortcut fixes is to enforce a four-phase debugging framework that requires explicit root-cause investigation, pattern analysis, and hypothesis testing before implementation, ensuring disciplined experimentation before changes.

Can I integrate systematic debugging with test-driven development?

Yes, you can integrate systematic debugging with test-driven development. The four-phase framework requires explicit hypothesis testing and pattern analysis, naturally aligning with test-driven development practices to confirm root causes before implementing fixes.

What are the anti-patterns to avoid during root cause investigation?

During root cause investigation, the main anti-patterns to avoid are skipping phases and applying shortcut fixes under pressure. If tempted to skip steps, review the Phase 4 anti-pattern guidance to maintain disciplined experimentation before changes.