Diagnose (Claude Code skill)
Tu invoques /diagnose sur Claude Code quand un bug résiste depuis 2h et que tes 30 console.log n'ont rien donné. La skill impose une discipline en 6 phases : reproduire, construire un feedback loop déterministe, hypothèses ranked falsifiables, instrumentation chirurgicale, fix + regression test, post-mortem. Distribuée par Matt Pocock dans son repo skills (github.com/mattpocock/skills), la phase 1 (build feedback loop) seule représente 90% du fix selon l'auteur.
Forces
- 6 phases nommées (reproduce → loop → hypothesise → instrument → fix → cleanup), fini le freestyle debugging
- Force 3-5 hypothèses ranked falsifiables avant de toucher du code, tue l'anchoring bias
- Tagging [DEBUG-xxxx] obligatoire sur tous les logs ajoutés, cleanup en un grep, zéro debug log oublié en prod
- Branche perf séparée (mesurer avant fixer) qui évite l'optimisation à l'aveugle
Limites
- Overkill sur les bugs simples, 6 phases pour une typo, c'est non
- Demande discipline réelle : si tu skippes la phase 1 (feedback loop), tout le reste devient théâtral
- Pas de garantie de stabilité d'API skill long terme (distribué hors registry Anthropic officielle)
Pour qui
- Devs qui se font piéger par les bugs non-déterministes (races, flaky e2e, perf regressions intermittentes)
- Tech leads qui veulent industrialiser une méthode partagée pour les post-mortems
- Équipes QA qui cherchent un protocole reproductible pour les bug reports verbeux