Debugging

Overview

Debugging is the systematic process of finding and fixing defects in software. This skill should be invoked when encountering bugs, errors, or unexpected behavior that requires methodical investigation and resolution.

Core Principles

• Reproducibility: Create consistent reproduction steps before fixing
• Evidence-Based: Use logs, breakpoints, and error messages as clues
• Hypothesis Testing: Form theories, then test them systematically
• Isolation: Narrow down the problem space through binary search

Preparation Checklist

• Gather full error messages and stack traces
• Identify the environment where issue occurs
• Collect relevant logs before and during the issue
• Understand expected vs actual behavior