Debugging Workflow

Use this skill when the task starts from a failure or unexplained behavior. Preserve business intent, isolate the smallest failing case, and fix the confirmed cause.

Operating Rules

• Reproduce before fixing when possible.
• Read logs, stack traces, test output, screenshots, and source-of-truth docs before changing code.
• Do not replace unusual business logic with a generic solution.
• Do not make broad refactors while the failure cause is still unknown.
• Form one hypothesis at a time and test it with the fastest reliable check.
• Keep temporary debug code local and remove it before completion.
• Add or update a regression test when practical.
• If the root cause is performance-related, switch to performance-optimization.
• If the main work becomes test strategy, switch to testing-verification.

Workflow

1. Capture The Failure