One-click install
npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill systematic-debugging-totvs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/totvs/engpro-advpl-tlpp-skills/tree/main/skills/superpowers/systematic-debugging
Command: npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill systematic-debugging-totvs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging prevents wasted time and new bugs by forcing you to identify the true root cause of failures and unexpected behavior before making any changes.

Core Features & Use Cases

  • Root-cause-first workflow: Enforces the iron law that you cannot propose fixes without completing root cause investigation.
  • Four-phase guardrails: Covers Investigation → Pattern Analysis → Hypothesis & Testing → Implementation with explicit stop/red-flag conditions.
  • Anti-rationalization under pressure: Helps resist common shortcuts like “quick fixes,” skipping evidence gathering, or iterating fixes on top of each other.
  • Debugging in multi-component systems: Guides evidence gathering across component boundaries to locate exactly where the failure occurs.

Quick Start

Use the skill to debug the current bug by following Phase 1 first—read the errors carefully, reproduce consistently, check recent changes, and trace data flow back to the triggering source before you implement anything.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of test failures before applying code fixes?

To find the root cause of test failures, you must enforce a systematic debugging workflow that completes evidence gathering and pattern analysis before proposing any code fixes. This prevents wasted time and new bugs.

What is the best way to systematically debug production defects and unexpected behavior?

Systematic debugging production defects requires a four-phase workflow: investigation, pattern analysis, single-hypothesis testing, and implementation. You must trace data flow and create a failing test before changing code.

How do I stop iterating on quick fixes when debugging multi-component system failures?

To stop iterating on quick fixes during multi-component debugging, apply strict stop rules when multiple fixes fail. Gather evidence across component boundaries to locate the exact failure source instead of rationalizing shortcuts.

Why should I create a failing test before implementing a code fix for a bug?

Creating a failing test before implementing a code fix ensures you have accurately reproduced the unexpected behavior and validated your root cause hypothesis. This prevents incorrect fixes and anti-flakiness in your system.

What are the limitations of systematic troubleshooting for build failures and integration problems?

Systematic troubleshooting for build failures and integration problems requires strict adherence to evidence gathering and single-hypothesis testing. It limits rapid patching but prevents compounding new bugs across component boundaries.