systematic-debugging

Implement a four-phase debugging framework to identify root causes before proposing fixes.

3|2|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/Crumbgrabber/llm_system_template_agents_skills_patterns_tools_prompts --skill systematic-debugging-crumbgrabber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Crumbgrabber/llm_system_template_agents_skills_patterns_tools_prompts/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/Crumbgrabber/llm_system_template_agents_skills_patterns_tools_prompts --skill systematic-debugging-crumbgrabber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common issue of inefficient and ineffective debugging by providing a structured, four-phase framework to ensure root cause analysis before implementing fixes, preventing wasted time and recurring bugs.

Core Features & Use Cases

  • Root Cause Investigation: Guides users through careful error analysis, reproduction steps, and evidence gathering in multi-component systems.
  • Pattern Analysis: Emphasizes finding similar working examples and understanding dependencies before proposing solutions.
  • Hypothesis Testing: Promotes the scientific method with single, testable hypotheses and minimal changes.
  • Implementation: Ensures fixes address the root cause, are verified with failing tests, and prompts architectural review if multiple fixes fail.
  • Use Case: When a critical test fails in a CI/CD pipeline, this Skill ensures the engineer systematically investigates the failure's origin rather than making a quick, potentially incorrect, patch.

Quick Start

Use the systematic-debugging skill to investigate the root cause of the recent 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 a test failure instead of just patching the symptom?

Root cause analysis for test failures requires a systematic debugging framework that investigates error messages, reproduces the issue, and traces data flow before proposing solutions. This approach ensures you identify the actual origin rather than applying a quick patch.

What is the best way to debug multi-component software systems?

Debugging multi-component software systems demands a structured approach covering error analysis, reproduction steps, evidence gathering, and pattern identification. Finding similar working examples and understanding dependencies ensures fixes address the root cause across the architecture.

How do I systematically reproduce an error and test a hypothesis for a bug?

Hypothesis testing for a bug involves formulating a single testable hypothesis and making minimal changes. By reproducing the error first and tracing data flow, you can scientifically verify whether your hypothesis addresses the root cause.

Why do my bug fixes keep failing or the same bugs keep recurring?

Recurring bugs often indicate fixes targeted symptoms rather than root causes. Without systematic debugging to analyze change tracking and architectural patterns, patches fail to resolve the underlying issue, causing repeated failures in the system.

When should I question my software architecture during troubleshooting?

Architectural questioning during troubleshooting becomes necessary when multiple fixes fail to resolve the issue. If systematic root cause investigation and minimal testing do not yield a solution, reviewing the architecture helps identify deeper structural problems.

Can I integrate systematic debugging with test-driven development?

Systematic debugging integrates directly with test-driven development by verifying fixes with failing tests. This ensures the bug is captured by a test before the fix is implemented, confirming the root cause is addressed and preventing regressions.