systematic-debugging

Identify root causes of bugs and failed tests through a four-phase debugging workflow.

4|2|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/lyfe2025/lyfes-coding-skills --skill systematic-debugging-lyfe2025
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lyfe2025/lyfes-coding-skills/tree/main/skills/superpowers/systematic-debugging
Command: npx skills add https://github.com/lyfe2025/lyfes-coding-skills --skill systematic-debugging-lyfe2025

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps engineers systematically locate the root causes of bugs and failed tests before proposing fixes, preventing symptom-focused patches and accelerating reliable software repair.

Core Features & Use Cases

  • Four-phase debugging workflow: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Defense-in-depth guidance: Add validations and guards across multiple layers to prevent recurrence.
  • Practical scenarios: Flaky tests, deep stack traces, cross-service bugs, and issues triggered by environment or timing.

Quick Start

Load the skill and follow the four-phase checklist:

  1. Observe and reproduce the symptom to establish a baseline.
  2. Use Root Cause Tracing to locate the original trigger.
  3. Perform Pattern Analysis to identify inconsistencies and dependencies.
  4. Form hypotheses, run focused tests, and implement a targeted fix with verification.

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 flaky tests instead of just patching symptoms?

Root cause debugging eliminates symptom-focused patches by guiding you through a four-phase workflow: observe and reproduce, trace the trigger, analyze patterns, and implement a targeted fix. This systematically prevents recurrence in flaky tests.

What is the best way to debug cross-service bugs across development and production environments?

Systematic debugging traces data flow and dependencies across environments to locate cross-service bugs. It formulates testable hypotheses based on deep stack traces to identify the original trigger before applying fixes.

How do I systematically analyze a deep stack trace to fix failing tests?

Analyze deep stack traces using a structured root cause investigation phase to locate the original trigger, followed by pattern analysis to identify inconsistencies and dependencies, ensuring you fix the actual failure rather than masking it.

Does defense-in-depth debugging prevent the same bugs from happening again?

Defense-in-depth debugging prevents recurrence by adding validations and guards across multiple layers after the root cause is found. This multi-layer approach ensures that even if one layer fails, others catch the issue.

How to debug intermittent timing and environment-triggered issues in production?

Debug intermittent production issues by first reproducing the symptom to establish a baseline, then tracing data flow and dependencies to formulate testable hypotheses that account for timing and environment-specific triggers.