Diagnosing Bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

This skill is imported from mattpocock/skills (MIT) and is model-invoked upstream.

When to use this skill

• Diagnosis loop for hard bugs and performance regressions.
• Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Instructions

Diagnosing Bugs

A discipline for hard bugs. Skip phases only when explicitly justified.

When exploring the codebase, read CONTEXT.md (if it exists) to get a clear mental model of the relevant modules, and check ADRs in the area you're touching.