agentic-systematic-debugging

Enforce a reproduce-first, root-cause-first debugging workflow with evidence and verification.

273|26|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/tmdgusya/roach-pi --skill agentic-systematic-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentic-systematic-debugging
Source: https://github.com/tmdgusya/roach-pi/tree/main/extensions/agentic-harness/skills/agentic-systematic-debugging
Command: npx skills add https://github.com/tmdgusya/roach-pi --skill agentic-systematic-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces a strict reproduce-first, root-cause-first, failing-test-first debugging workflow to reduce guesswork and ensure verifiable fixes.

Core Features & Use Cases

  • Enforces reproduction before analysis to ensure failures are observable.
  • Guides debugging through evidence collection, root-cause hypothesis, and validation of fixes.
  • Applicable to bugs, test failures, and unexpected behavior across development, CI, and production environments.

Quick Start

Begin by reproducing the issue, collect evidence with a minimal reproduction, state a root-cause hypothesis, lock a failing guard, implement a single fix, and verify against the original reproduction path.

Frequently Asked Questions about agentic-systematic-debugging

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

FAQPage Schema
How do I systematically debug a bug instead of guessing the fix?

Systematic debugging enforces a reproduce-first workflow by requiring a minimal reproduction, explicit evidence collection, a defined root-cause hypothesis, a failing guard, and post-fix verification to eliminate guesswork.

What is the best way to reproduce a test failure before attempting a fix?

The best way to reproduce a test failure is to enforce a reproduction attempt before analysis, ensuring the failure is observable through minimal reproduction and explicit evidence capture across CI or production environments.

Why should I write a failing guard before fixing unexpected behavior?

Writing a failing guard before fixing unexpected behavior locks the root-cause hypothesis, ensuring your single targeted fix can be validated against the original reproduction path through post-fix verification.

Can I use a reproduce-first debugging workflow for CI pipeline failures?

Yes, a reproduce-first debugging workflow is applicable to CI pipeline failures, test failures, and unexpected behavior, guiding you through evidence collection, hypothesis isolation, and validated fixes across development environments.

How do I isolate the root cause of a bug after collecting evidence?

To isolate the root cause of a bug after collecting evidence, you state a defined root-cause hypothesis, implement a single fix targeting that specific hypothesis, and then run post-fix verification against the original reproduction.

What are the limitations of a root-cause-first debugging approach?

A root-cause-first debugging approach requires a strict sequence of reproduction, evidence collection, and hypothesis validation, making it less suitable for quick fixes when a bug cannot be reliably reproduced or observed.