What problem does it solve?
When a test, runtime, data, integration, or operational failure has multiple plausible causes, jumping to the first plausible story leads to wrong fixes. This Skill structures the diagnosis so the observable signal is stabilized first, rival explanations are tested against evidence, and inconclusive outcomes stay honest.
Core Features & Use Cases
- Rival-hypothesis testing: Generates at least three hypotheses that differ in kind, each with a discriminating probe that could refute it.
- Parallel read-only investigation: Assigns each hypothesis to an investigator running read-only probes in parallel, with edits prohibited during diagnosis.
- Evidence-ranked conclusions: Ranks hypotheses by evidence for, evidence against, and remaining uncertainty while keeping refuted rivals visible for fallback or replay.
- Optional project-memory integration: Uses Haft MCP queries to resolve project context and, only on explicit request, persists a diagnosis frame or hypothesis portfolio.
- Use Case: A CI test fails intermittently after a dependency upgrade. Use this Skill to stabilize the failure signal, generate rival explanations (timing race, version incompatibility, environment drift), probe each read-only in parallel, and report the leading explanation with live rivals.
Quick Start
Ask the agent to diagnose the observed failure, for example: "Diagnose why the payment integration test fails intermittently in CI using h-diagnose."