systematic-debugging

Diagnose software bugs using a four-phase root-cause isolation methodology.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/JenilRevaliya/ARGUS --skill systematic-debugging-jenilrevaliya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/JenilRevaliya/ARGUS/tree/main/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/JenilRevaliya/ARGUS --skill systematic-debugging-jenilrevaliya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging complex or intermittent bugs often leads to guesswork, shotgun fixes, and wasted time. This Skill enforces a disciplined, evidence-based debugging process that isolates root causes before any code is changed. ## Core Features & Use Cases - 4-Phase Methodology: Replication and isolation, hypothesis generation, evidence-based probing, and verified resolution with minimal changes. - Advanced Diagnostic Vectors: Identifies race conditions, state leakage, and silent failures caused by swallowed errors or missing awaits. - Git Bisection & Stack Trace Analysis: Uses git bisect for O(log N) commit isolation and teaches proper stack trace reading to find the true failure point. - Use Case: A production endpoint fails intermittently. Use this Skill to reproduce the failure deterministically, form a hypothesis from logs, probe with targeted logging, and apply a single verified fix. ## Quick Start Debug the intermittent login failure in my app using the systematic debugging methodology, starting with reproducing the bug and tracing the root cause.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a bug that only happens intermittently?▼

Intermittent bugs usually indicate race conditions or timing issues, such as missing await statements or unordered async callbacks. First write a deterministic test that reproduces the failure reliably, then probe with targeted logging to confirm the hypothesis before changing code.

How to find which commit introduced a bug using git?▼

Use git bisect to isolate the faulty commit in O(log N) steps. Mark the current broken state with git bisect bad, mark a known-good release with git bisect good, then test each midpoint commit Git checks out until the exact offending commit is found.

Why does my app fail on the second operation but not the first?▼

This pattern indicates state leakage, typically caused by global variables, cached HTTP clients, or missing cleanup in component unmount logic. Inspect shared mutable state between operations and add logging probes to confirm which state persists incorrectly.

How do I read a stack trace to find the root cause?▼

Start with the top line for the fatal error, then scroll past framework and node_modules frames to the first function you wrote. That line shows where the failure surfaced; trace upward through the call stack to find why invalid data was passed in.

Why is my error not showing up in the logs?▼

Silent failures usually come from empty catch blocks, unhandled promise rejections, or conditional rendering that hides missing data. Audit catch handlers and promise chains, and add explicit logging at each stage of the failing operation.