#22 by installsCoding & architecture
diagnosing-bugs
Systematic diagnosis loop for hard bugs and performance regressions with tight feedback loops
716K
41.8K
276.1K
Jun 4, 2026
Install
npx skills add https://github.com/mattpocock/skills --skill diagnosing-bugsWhat it does
A disciplined approach to debugging complex issues by prioritizing tight pass/fail feedback loops over code inspection. Use when facing hard-to-reproduce bugs, performance regressions, or cryptic failures. Emphasizes building instrumentation and test harnesses before hypothesis testing, with careful redaction of secrets in all artifacts.
- Constructs tight feedback loops (pass/fail signals) before diving into code exploration
- Guides systematic bisection and hypothesis testing against reproducible test cases
- Reads GLOSSARY.md and ADRs to build accurate mental models of affected modules
- Securely redacts credentials and secrets while capturing diagnostic artifacts for analysis
