debug

Reproduce failing tests and runtime errors to prove root causes with file:line evidence.

26|8|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/arbazkhan971/godmode --skill debug-arbazkhan971
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/arbazkhan971/godmode/tree/main/skills/debug
Command: npx skills add https://github.com/arbazkhan971/godmode --skill debug-arbazkhan971

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates guesswork when tests or runtime behavior fail by enforcing a reproduce → investigate → prove discipline that finds, documents, and verifies root causes with concrete evidence.

Core Features & Use Cases

  • Reproduce reliably: run the failing test/command multiple times to distinguish deterministic failures from flaky ones.
  • Investigation techniques: apply stack trace analysis, git bisect (binary search), state inspection, minimal reproduction, and dependency isolation with a strict 5-minute-per-technique timeout.
  • Prove and document: require file:line plus actual vs expected values, perform at least three "why" steps, log findings to .godmode/debug-findings.tsv, and hand off non-trivial fixes to /godmode:fix.
  • Failure safety: rules for skipping stuck bugs, rollback on catastrophic failure, and classification of skipped bugs for future lessons.

Quick Start

Run the debug loop on the failing test command, reproduce the failure three times, pick an investigation technique (stack trace, git bisect, or state inspection), prove the root cause with file:line and actual vs expected values, and either apply a one-line fix or hand off to /godmode:fix.

Frequently Asked Questions about debug

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

FAQPage Schema
How do I debug failing tests and prove the root cause of runtime errors?

To debug failing tests and runtime errors, reproduce the failure three times to distinguish deterministic bugs from flaky ones, then apply stack trace analysis, git bisect, or state inspection to prove the root cause with file:line evidence.

What is the best way to use git bisect for finding intermittent test failures in CI?

The best way to use git bisect for intermittent test failures is to run the failing command multiple times to confirm the flaky behavior, then apply git bisect as a binary search technique with a strict 5-minute timeout per investigation step.

How do I document root causes when bug hunting across codebases?

To document root causes when bug hunting, perform at least three "why" steps to prove the failure, collect file:line evidence with actual-vs-expected values, and append the structured findings to the .godmode/debug-findings.tsv file.

What should I do when my debugging technique gets stuck on a runtime error?

When your debugging technique gets stuck on a runtime error, the investigation enforces a strict 5-minute-per-technique timeout, skips the stuck bug, rolls back on catastrophic failure, and classifies it for future lessons.

Does this debugging approach handle both deterministic and flaky CI test failures?

Yes, this debugging approach handles both deterministic and flaky CI test failures by reliably reproducing the failing command multiple times to distinguish the failure type before choosing an investigation technique.