ia-debugging

Trace errors and regressions to root causes with evidence and regression tests.

30|3|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/iliaal/whetstone --skill ia-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ia-debugging
Source: https://github.com/iliaal/whetstone/tree/main/plugins/whetstone/skills/ia-debugging
Command: npx skills add https://github.com/iliaal/whetstone --skill ia-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Systematic root-cause debugging that prevents premature fixes by requiring evidence-backed analysis and verification.

Core Features & Use Cases

  • Root-cause-first process: Trace symptoms backward, form competing hypotheses, and document evidence with file:line references.
  • Reproduction and regression-proofing: Build the cheapest reliable loop, then reduce to a minimal failing case and add a regression test.
  • Defense-in-depth validation: Verify at multiple layers (entry, business logic, environment, instrumentation) before claiming the bug is resolved.
  • Use Cases: Fixing failing or flaky tests, resolving regressions, diagnosing stack-trace issues, and validating bug reports before making changes.

Quick Start

Ask an AI coding agent to debug a failing test by reproducing the issue, tracing backward to the root cause with evidence, and verifying the fix with a regression test.

Frequently Asked Questions about ia-debugging

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

FAQPage Schema
How do I find the root cause of a failing test instead of just patching the symptom?

Root cause debugging requires tracing symptoms backward to form competing hypotheses grounded in evidence with file:line references. You reproduce the issue reliably, reduce it to a minimal failing case, and validate fixes across multiple layers before claiming resolution.

What is the best way to debug flaky tests and prevent future regressions?

Debugging flaky tests involves building the cheapest reliable reproduction loop, then reducing the failure to a minimal case. Regression prevention is achieved by adding a dedicated regression test that validates the specific fix before completing the workflow.

How do I systematically diagnose stack trace errors and broken tests?

Systematic diagnosis applies evidence-based backward tracing from the stack trace to the origin point. You form hypotheses using grounded observations, validate across entry, business logic, environment, and instrumentation layers, and document findings in a structured Debug Report.

Why does fixing a bug without verification lead to recurring incidents?

Fixing bugs without verification risks incomplete resolution because defense-in-depth validation checks entry, business logic, environment, and instrumentation layers. Skipping structured regression testing means underlying root causes remain unverified and can trigger future regressions.

Can I use systematic debugging workflows for diagnosing incident postmortems?

Systematic debugging workflows apply directly to incident postmortems by requiring evidence-backed analysis. You trace backward from symptoms, document hypotheses with file:line references, and produce a structured Debug Report to validate the incident root cause before applying fixes.

Does root cause debugging work for reproducing issues across multiple components?

Root cause debugging works for multi-component issues by applying defense-in-depth validation. You verify the fix at entry, business logic, environment, and instrumentation layers, ensuring the reproduction loop reliably validates behavior across all affected components.