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.