systematic-debugging

Root-cause debugging starts by reproducing the failure reliably and gathering evidence—error messages, logs, traces—before proposing any fix. This Skill enforces a structured 4-phase process: investigate the root cause, analyze patterns across the system, form and test hypotheses, then implement targeted changes. This prevents applying surface-level patches that mask deeper issues.

Systematic troubleshooting maps error paths through multi-component systems using diagnostic instrumentation and reproducible data collection. This Skill guides you through mandatory evidence gathering and structured root-cause investigation before fixes, ensuring you identify which component or interaction caused the failure rather than guessing at symptoms.

Root-cause investigation for performance applies the same evidence-first approach: reproduce the issue reliably, trace execution paths to identify bottlenecks, analyze patterns, form testable hypotheses, and validate before optimization. This Skill prevents premature optimization by enforcing diagnostic data collection that reveals the actual source of slowness.

Yes. Traceback analysis maps error paths across service boundaries to pinpoint integration failures. This Skill applies its 4-phase root-cause process to integration problems, requiring diagnostic instrumentation across components and structured hypothesis testing so you identify the exact interaction causing failures.

Fixing without understanding root cause often masks underlying issues—your fix may pass the test but leave the real problem unresolved. This Skill enforces evidence-first reasoning: gather error data, trace failure paths, and confirm the actual cause before implementing changes, so fixes are minimal, targeted, and address the real defect.

Common anti-patterns include skipping reproduction steps, applying fixes without evidence, ignoring multi-component context, and yielding to time pressure. This Skill explicitly resists these shortcuts by mandating diagnostic instrumentation, structured analysis phases, and reproducible data collection before any fix, ensuring thorough root-cause clarity.