skills.rest
SpecForgeAI
SpecForgeAIOFFICIAL
Explore all skills by this author →
GitHub

sp_debugging

Guide root-cause debugging of bugs and test failures with a structured workflow.

Updated Aug 23, 2026
Search Tags:#debugging#troubleshooting#root-cause#reproduction#phased-diagnosis#test-driven-fix
One-click install
npx skills add https://github.com/SpecForgeAI/deepagent-bot --skill sp-debugging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sp_debugging
Source: https://github.com/SpecForgeAI/deepagent-bot/tree/main/skills/sp_debugging
Command: npx skills add https://github.com/SpecForgeAI/deepagent-bot --skill sp-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new bugs. Quick patches mask underlying issues. Systematic debugging ensures you identify the root cause before attempting fixes.

Core Features & Use Cases

  • Structured root-cause investigation workflow that guides error analysis from message reading to final verification.
  • Phase-driven approach (read errors, reproduce, check changes, gather evidence, trace data flow, form a hypothesis, test minimally, confirm, implement) for reliable fixes.
  • Fosters evidence-based decision-making and creates robust, test-driven changes with minimal risk.

Quick Start

Provide a failing test case and let the stepwise debugging flow guide the root-cause investigation.

Frequently Asked Questions about sp_debugging

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

FAQPage Schema
How do I find the root cause of a failing test instead of just patching symptoms?▼

Root-cause debugging uses a structured, phased workflow to trace data flow, gather evidence, and form a hypothesis before fixing. This enforces evidence-based decision-making and requires a failing test to verify the minimal fix.

What is the best way to systematically debug unexpected behavior across my codebase?▼

Systematic debugging applies a phase-driven approach: read errors, reproduce the issue, check changes, gather evidence, trace data flow, form a hypothesis, test minimally, and confirm. This prevents random fixes that create new bugs.

How do I reproduce a bug before attempting a code fix?▼

Bug reproduction is a core phase of systematic debugging. You provide a failing test case, then the stepwise flow guides error interpretation and data-flow tracing to reliably reproduce the unexpected behavior before changing code.

Does systematic debugging work without writing a failing test first?▼

No, test-driven fixes are mandatory. The disciplined workflow requires a failing test before attempting fixes and halts ill-defined changes after repeated failures to ensure robust, minimal-risk changes.

When should I avoid quick patches for test failures?▼

Quick patches mask underlying issues and should be avoided during root-cause debugging. Random fixes waste time and create new bugs, whereas a phased investigation ensures you identify the true root cause before implementing a fix.

Can I use phased diagnosis for error interpretation in any test suite?▼

Yes, phased diagnosis applies across codebases and test suites. It guides error interpretation, change evaluation, and evidence gathering regardless of the specific environment, ensuring reliable fixes with minimal risk.

Related Skills

Explore More Software Engineering Skills→
allexcdallexcd

autonomous-bug-fixing

Diagnose, reproduce, and fix code defects from bug reports or error logs.

Community
Advanced
tomguntomgun

fixing-bugs

Reproduce bugs with regression tests and apply minimal root-cause fixes.

Community
Intermediate
Till-Crazy-Tears-Us-ApartTill-Crazy-Tears-Us-Apart
27

systematic-debugging

Guide structured four-phase debugging to identify root causes of software bugs.

Community
Advanced
theslashdojotheslashdojo

mongosh

Run mongosh shell commands with --eval or --file against MongoDB deployments.

Official
Intermediate