evanflow-debug

Coordinate end-to-end bug investigation with reproduction, hypothesis testing, and failing-tests-first fixes.

417|18|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/evanklem/evanflow --skill evanflow-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evanflow-debug
Source: https://github.com/evanklem/evanflow/tree/main/skills/evanflow-debug
Command: npx skills add https://github.com/evanklem/evanflow --skill evanflow-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging complex bugs and unexpected behavior is time-consuming and error-prone; this skill provides a repeatable, root-cause workflow that enforces explicit reproduction, hypothesis formation, and guarded fixes to reduce firefighting.

Core Features & Use Cases

  • Reproduce the exact bug with environment and steps to confirm failure.
  • Form explicit hypotheses and challenge them with an embedded grill.
  • Write a failing test first and fix the root cause, not the symptom.
  • Verify changes with targeted tests and non-destructive hand-offs; applicable to failing tests, production issues, and behavior mismatches.

Quick Start

Reproduce the bug, state a hypothesis, run the embedded grill to test it, add a failing test, fix the root cause, and validate the fix.

Frequently Asked Questions about evanflow-debug

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

FAQPage Schema
How do I find the root cause of a bug instead of just fixing the symptom?

Root-cause debugging requires reproducing the exact failure, forming explicit hypotheses, and challenging them with an embedded grill. You then write a failing test first to ensure your fix targets the underlying cause rather than the surface symptom.

What is a grill-led hypothesis in debugging workflows?

A grill-led hypothesis in debugging is an explicit assumption about a bug's origin that is rigorously challenged and tested before any code changes. This disciplined approach prevents premature fixes by verifying the hypothesis against instrumented test data.

How do I debug a failing test using a structured workflow?

To debug a failing test, reproduce the exact environment and steps that confirm the failure. State a hypothesis, run the embedded grill to test it, write a failing test, fix the root cause, and validate the fix with targeted tests.

Can I use this root-cause debugging method for production anomalies?

Yes, this root-cause debugging method works for production anomalies by applying a disciplined sequence from reproduction to verification. It ensures non-destructive changes with explicit hand-offs, making it safe for complex code paths and unexpected production behavior.

What is the best way to ensure non-destructive changes during bug resolution?

The best way to ensure non-destructive changes is to verify fixes with targeted tests and use explicit hand-offs. This disciplined debugging workflow requires writing a failing test first, fixing the root cause, and validating the change before completing the hand-off.