debugging-practice

Apply a six-step debugging procedure to isolate root causes of software failures.

Updated Oct 15, 2021
One-click install
npx skills add https://github.com/toqoz/config --skill debugging-practice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-practice
Source: https://github.com/toqoz/config/tree/main/home/agents/skills/debugging-practice
Command: npx skills add https://github.com/toqoz/config --skill debugging-practice

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common tendency to rely on intuition or blame external systems when software fails, providing a structured framework to isolate and resolve issues efficiently.

Core Features & Use Cases

  • Disciplined Elimination: Follows a rigorous, step-by-step procedure to rule out local causes before investigating external dependencies.
  • Root-Cause Analysis: Provides heuristics to prioritize the most likely sources of failure, such as recent code changes or configuration mismatches.
  • Use Case: When a feature stops working after a deployment, use this Skill to systematically verify your assumptions, isolate the failing boundary, and confirm the root cause with evidence.

Quick Start

Apply the debugging-practice framework to the current issue by describing the symptom and identifying the most recent local changes.

Frequently Asked Questions about debugging-practice

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

FAQPage Schema
What is the best way to approach software debugging when a feature stops working after deployment?

Software debugging should follow a disciplined, six-step procedure that prioritizes local code inspection and boundary isolation before escalating to external systems. This structured methodology ensures you systematically rule out local causes using evidence-based root-cause analysis.

How do I isolate integration errors and runtime anomalies without immediately blaming external systems?

To isolate integration errors and runtime anomalies, start with disciplined elimination by inspecting local code and recent changes first. You must rule out local causes and configuration mismatches through boundary isolation before investigating external dependencies.

What heuristics help with root-cause analysis for unexpected test failures?

Root-cause analysis for unexpected test failures prioritizes the most likely sources of failure, such as recent code changes or configuration mismatches. By methodically verifying assumptions against evidence, you can confirm the exact origin of the anomaly.

When should I escalate to external systems during troubleshooting?

You should only escalate to external systems during troubleshooting after completing local code inspection and boundary isolation. The methodology requires ruling out all local causes and configuration mismatches through disciplined elimination before investigating external dependencies.

Does this debugging methodology apply to configuration mismatches and recent code changes?

Yes, this debugging methodology specifically applies to configuration mismatches and recent code changes by providing heuristics to prioritize them as likely failure sources. It guides you to systematically verify these assumptions with concrete evidence.