debugging-and-error-recovery

Convert failure signals into evidence-preserving debugging and minimal-fix recovery workflows.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/Handy369/passto-pi-frame --skill debugging-and-error-recovery-handy369
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/Handy369/passto-pi-frame/tree/main/skills/debugging-and-error-recovery
Command: npx skills add https://github.com/Handy369/passto-pi-frame --skill debugging-and-error-recovery-handy369

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you recover from already-occurring failures by turning vague “something broke” situations into a tight loop of evidence preservation, reliable reproduction, root-cause identification, and a minimal fix with regression protection.

Core Features & Use Cases

  • Failure-first Debug Orchestration: Ensures the workflow starts with stopping further changes and preserving error outputs, logs, and reproduction steps before any coding continues.
  • Root Cause Localization & Minimal Fix: Guides narrowing the failure surface (UI/API/DB/build/external service/test itself), finding the smallest failing case, and fixing the underlying cause rather than symptoms.
  • Regression Guard & Recovery Verification: Requires adding guardrails (e.g., tests) when appropriate and completing the smallest end-to-end verification to confirm the system is truly recovered.

Quick Start

Tell the AI: “My tests/build/runtime failed—stop line, preserve the failure evidence, reproduce it stably, locate the root cause, implement the minimal fix, and add regression protection, then run the smallest verification to confirm recovery.”

Frequently Asked Questions about debugging-and-error-recovery

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

FAQPage Schema
How do I debug a runtime exception and find the root cause?

Debugging a runtime exception requires preserving error outputs and logs first, then creating a stable reproduction to localize the failure surface before implementing a minimal root-cause fix with regression protection.

What is the best way to reproduce test failures stably for root cause analysis?

The best way to reproduce test failures stably is to halt further modifications, preserve the exact error outputs and logs, and isolate the smallest failing case to accurately localize the underlying root cause before fixing.

How do I fix a broken build without introducing new issues?

Fix a broken build without introducing new issues by localizing the root cause and applying a minimal fix, then adding regression tests as guardrails and running the smallest end-to-end verification to confirm system recovery.

Can I use this debugging workflow for log triage and error recovery in any software project?

Yes, you can use this workflow for log triage and error recovery in any software project because it applies broadly to test failures, broken builds, runtime exceptions, and explicit error messages across UI, API, DB, and external service layers.

Why should I preserve failure evidence before fixing a runtime exception?

Preserve failure evidence before fixing a runtime exception to ensure you have reliable logs and reproduction steps, which prevents symptom-focused patches and enables accurate root-cause localization for a truly recovered system.

What should I do if my regression testing fails after a minimal root cause fix?

If regression testing fails after a minimal root cause fix, you should restart the failure-first debug orchestration by preserving the new error evidence, reproducing the failure stably, and verifying the failure surface localization again.