diagnose

Diagnose hard bugs through a six-phase loop from reproduction to regression-testing.

Updated May 7, 2026
One-click install
npx skills add https://github.com/hgxszhj/mattpocock_skills --skill diagnose-hgxszhj
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: diagnose
Source: https://github.com/hgxszhj/mattpocock_skills/tree/main/skills/engineering/diagnose
Command: npx skills add https://github.com/hgxszhj/mattpocock_skills --skill diagnose-hgxszhj

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes scripts (resource) components.

What problem does it solve?

Disciplined diagnosis loop for hard bugs and performance regressions by guiding you from reproduction β†’ minimise β†’ hypothesise β†’ instrument β†’ fix β†’ regression-test.

Core Features & Use Cases

  • A structured six-phase workflow: reproduce β†’ minimise β†’ hypothesise β†’ instrument β†’ fix β†’ regression-test.
  • Guidance on building fast feedback loops, selecting deterministic signals, and documenting hypotheses with testable predictions.
  • Use when a user reports a bug, a performance drop, or an unpredictable failure and you need a repeatable debugging process.

Quick Start

Run the six-phase diagnosis loop on the active bug report to reproduce, minimise, hypothesise, instrument, fix, and regression-test.

Frequently Asked Questions about diagnose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a systematic debugging loop for resolving hard bugs?β–Ό

Systematic debugging for hard bugs requires a deterministic feedback loop, instrumentation for signals, and explicit progression criteria to validate hypotheses. It applies to crashes, performance regressions, and ambiguous failures across projects.

How do I debug a performance regression using a phased workflow?β–Ό

Debug a performance regression by applying the six-phase diagnosis loop: reproduce the drop, minimise the trigger, hypothesise the cause, instrument for deterministic signals, apply the fix, and regression-test the result.

How do I minimise a bug reproduction for faster feedback loops?β–Ό

Minimise a bug reproduction by isolating the deterministic trigger and stripping extraneous variables. The debugging loop uses this minimised case to build fast feedback loops, select deterministic signals, and document testable hypotheses.

When do I need instrumentation during software debugging?β–Ό

Instrumentation is needed during software debugging to capture deterministic signals that validate or invalidate documented hypotheses. It provides the explicit feedback required before progressing to the fix and regression-testing phases.

Does this debugging workflow require defined project glossaries and ADRs?β–Ό

Yes, this debugging workflow applies to software debugging tasks across projects with a defined glossary and ADRs. These artifacts provide the contextual boundaries needed for accurate reproduction and regression-testing.

What are the limitations of using a disciplined diagnosis loop for ambiguous failures?β–Ό

The disciplined diagnosis loop for ambiguous failures requires a deterministic feedback loop to function correctly. Without deterministic signals and explicit progression criteria, validating hypotheses and fixes for unpredictable failures becomes unreliable.