{"enrichment":{"faq":[{"a":"systematic-debugging guides you through a disciplined five-phase workflow to eliminate guesswork and prevent band-aid fixes. You start by reliably reproducing the issue, then systematically narrow down the failing component, trace the chain of causation, apply a minimal fix at the root cause, and finally verify the solution works without introducing new problems. The methodology emphasizes understanding *why* a bug occurs before attempting repairs.","q":"What is the systematic-debugging skill's core approach?"},{"a":"systematic-debugging's workflow consists of five phases: first, reliably reproduce the bug so you can observe it consistently; second, systematically narrow down which component is failing; third, trace the chain of causation to understand how the error propagates; fourth, apply a minimal fix directly at the root cause rather than masking symptoms; and fifth, verify your fix works and doesn't introduce regressions. This structured approach prevents jumping to conclusions.","q":"How do I follow a step by step debugging workflow?"},{"a":"systematic-debugging teaches you to isolate bugs by first reproducing them reliably, then methodically narrowing the scope of investigation. Rather than applying random changes, you trace the error's origin by examining the chain of causation\u2014following how data flows and functions call each other. This disciplined isolation prevents the common pitfall of shotgun debugging, where developers make multiple changes without understanding which one actually fixes the problem.","q":"How does systematic-debugging help isolate bugs in code?"},{"a":"systematic-debugging helps you avoid band-aid fixes that mask symptoms without addressing root causes, shotgun debugging where you change multiple things at once, and guesswork-driven troubleshooting. By emphasizing understanding *why* a bug occurs before repairs, and by requiring verification that fixes don't introduce regressions, the skill steers you toward proper solutions that remain stable and maintainable.","q":"What common debugging mistakes does this skill help me avoid?"},{"a":"systematic-debugging's first phase focuses on reliably reproducing the issue\u2014critical for intermittent bugs that are hard to trigger. The skill guides you to identify the conditions, inputs, or timing that cause the bug to appear consistently, transforming a sporadic problem into a reproducible one. Once you can trigger it reliably, the remaining phases of narrowing, tracing, fixing, and verifying become much more effective.","q":"How can systematic-debugging help me reproduce intermittent errors?"},{"a":"systematic-debugging includes a dedicated verification phase where you confirm your fix resolves the original issue and doesn't introduce new problems or regressions. This final phase ensures your minimal root-cause fix actually solves the problem you identified through tracing, and that the solution is stable and complete rather than a temporary workaround.","q":"How does systematic-debugging verify that bug fixes work properly?"}],"shadow_tags":["root-cause-analysis","error-investigation","troubleshooting-methodology","regression-testing","code-tracing","binary-search-debugging","hypothesis-driven-debugging","anti-pattern-avoidance","reproducible-failures","verification-gates"],"summary_rewrite":"This skill guides you through a disciplined five-phase debugging workflow designed to eliminate guesswork and prevent band-aid fixes. Start by reliably reproducing the issue, then systematically narrow down the failing component, trace the chain of causation, apply a minimal fix at the root cause, and finally verify the solution works without introducing new problems. The methodology emphasizes understanding *why* a bug occurs before attempting repairs."},"files":[{"bytes":5219,"path":"universal/debugging/systematic-debugging/SKILL.md","sha256":"88c1d2d7c6a51202c71ceebe8d0fcac55d2547139b5076e5726c510c33fefa51","url":"https://skillfed.io/files/bobmatnyc/claude-mpm-skills/systematic-debugging/6da959c6/SKILL.md"}],"id":"bobmatnyc/claude-mpm-skills/systematic-debugging","links":{"html":"https://skillfed.io/bobmatnyc/claude-mpm-skills/systematic-debugging","md":"https://skillfed.io/bobmatnyc/claude-mpm-skills/systematic-debugging.md","repo":"https://github.com/bobmatnyc/claude-mpm-skills"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":18,"language":"Python","last_updated":"2026-07-18","license":"MIT","name":"systematic-debugging","publisher":"bobmatnyc","stars":62},"relations":{"categories":["debugging","quality-assurance","software-engineering"],"similar":[{"id":"bobmatnyc/claude-mpm-skills/root-cause-tracing"},{"id":"spencerpauly/awesome-cursor-skills/systematic-debugging"},{"id":"bobmatnyc/claude-mpm-skills/software-patterns"},{"id":"Jeffallan/claude-skills/debugging-wizard"},{"id":"vudovn/ag-kit/systematic-debugging"},{"id":"itzzritik/OrderWorder/systematic-debugging"},{"id":"ctsstc/get-shit-done-skills/debugger"},{"id":"PracticalSwan/agent-skills/systematic-debugging"},{"id":"secondsky/claude-skills/systematic-debugging"},{"id":"travisjneuman/.claude/debug-systematic"}]},"slug":{"owner":"bobmatnyc","repo":"claude-mpm-skills","skill":"systematic-debugging"},"version":"6da959c6"}