systematic-debugging

Diagnose software issues through a structured root-cause workflow.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/radenadri/skills-alena --skill systematic-debugging-radenadri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/radenadri/skills-alena/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/radenadri/skills-alena --skill systematic-debugging-radenadri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random debugging attempts waste time and create new issues. This skill provides a disciplined, root-cause-first approach to diagnosing software problems.

Core Features & Use Cases

  • Structured, phase-based workflow covering reproduction, isolation, tracing, and verification.
  • Guidance for handling production bugs, flaky tests, performance problems, and integration issues.
  • Evidence-driven debugging with documented root causes to prevent regressions.

Quick Start

Initiate Phase 1 by reproducing the issue with a minimal repro and collecting exact steps, errors, and observed behavior.

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 flaky test instead of guessing?

To find the root cause of a flaky test, use a structured debugging workflow that enforces phase-based reproduction, isolation, and tracing. This evidence-driven approach collects exact steps and observed behavior to prevent future regressions.

What is the best way to debug production bugs systematically?

The best way to debug production bugs systematically is through a rigorous root-cause framework covering reproduction, isolation, tracing, and verification. This disciplined approach replaces random attempts with documented evidence to prevent regressions.

How do I isolate a software issue when debugging across diverse codebases?

To isolate a software issue across diverse codebases, apply a phase-based workflow that enforces explicit evidence collection and tracing. This framework guides you from minimal reproduction through documented root cause identification.

Can I use git-bisect for root-cause debugging on performance problems?

Yes, root-cause debugging applies to performance problems using isolation techniques like git-bisect within a structured phase workflow. It guides reproduction, tracing, and verification to pinpoint the exact cause without random attempts.

Why does random debugging waste time and create new issues?

Random debugging wastes time because it lacks a disciplined, root-cause-first approach. Without a structured workflow for reproduction, isolation, and tracing, attempts rely on guesswork and introduce new issues instead of documenting the actual root cause.

How do I start phase 1 of a root-cause debugging workflow?

To start phase 1 of root-cause debugging, reproduce the issue with a minimal reproduction case. Collect exact steps, errors, and observed behavior to establish a baseline for the subsequent isolation, tracing, and verification phases.