debugging-strategies

The debugging workflow involves four phases: reproduce the issue with exact steps, gather context like logs and environment details, form a testable hypothesis, and verify the fix using tests to ensure safe resolution.

To reproduce a production incident for root-cause analysis, establish exact steps that reliably trigger the issue, then collect context, logs, and environment data needed to form and test a verification hypothesis.

Debug a performance regression by applying a phase-based workflow: reproduce the regression, gather diagnostic data through profiling and logging, isolate components, hypothesize the root cause, and verify performance restoration through testing.

No specific dependencies are required. The skill provides scripts, references, and assets to guide the debugging process, making it accessible for any software engineering environment facing bugs or performance regressions.

Use logging strategies that collect detailed context and environment data during reproduction to isolate components, enabling you to form accurate hypotheses and perform test-based verification of the fix.