debugging-craft

What problem does it solve?

Debugging-craft turns confusing, failing, or intermittent failures into a reproducible, minimizable investigation so you can find and fix the real root cause instead of patching symptoms.

Core Features & Use Cases

• Reproduce and minimize failures using SSCCE/delta debugging so the bug becomes reliably triggerable and easier to analyze.
• Observe before theorizing by forcing the agent to prove hypotheses with logs/assertions rather than assumptions.
• Iterate hypothesis → experiment → bisect to isolate the introducing cause (input/code/process) and then verify the fix by re-triggering the original failure.

Quick Start

Use debugging-craft when your verification command fails by instructing the agent to reproduce the failure, minimize it to the smallest failing case, then run a hypothesis-experiment loop with bisection and a final re-verification that proves the original failure is gone.