Debugging and Error Recovery

Adapted from addyosmani/agent-skills (MIT), commit 82ceff41ed4d3c644e3dcca8a0514390b2911223.

Overview

Debugging should be systematic. Preserve evidence, reproduce the failure, localize the cause, fix the root cause, and add a guard against recurrence.

When to Use

• Tests fail after a change
• The build breaks
• Runtime behavior is wrong or inconsistent
• A bug report arrives with reproducible steps or logs

Stop-The-Line Rule

When something unexpected happens: