openagent-systematic-debugging

Identify and resolve bugs through OpenAgent's four-phase approval-gated debugging workflow.

Updated Sep 16, 2025
One-click install
npx skills add https://github.com/SvenMarcus/.dotfiles --skill openagent-systematic-debugging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openagent-systematic-debugging
Source: https://github.com/SvenMarcus/.dotfiles/tree/main/opencode/.config/opencode/skills/custom/openagent-systematic-debugging
Command: npx skills add https://github.com/SvenMarcus/.dotfiles --skill openagent-systematic-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The OpenAgent systematic debugging skill provides a structured, approval-gated workflow to identify root causes before proposing fixes, reducing wasted time and rework in debugging sessions.

Core Features & Use Cases

  • Four-phase debugging with mandatory OpenAgent approvals at each checkpoint.
  • Comprehensive evidence collection and reporting to the user after each phase.
  • Safe, iterative hypothesis testing and implementation with clear rollback and re-analysis options.

Quick Start

Initiate a four-phase OpenAgent systematic debugging session for a failing issue, requesting phase approvals before each step and reporting findings at each checkpoint.

Frequently Asked Questions about openagent-systematic-debugging

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

FAQPage Schema
What is a systematic debugging workflow with approval gates?▼

A systematic debugging workflow with approval gates is a structured process requiring explicit user confirmation at each checkpoint before advancing through phases of root cause investigation, hypothesis testing, and safe implementation.

How do I find a root cause before applying a code fix to a failing test?▼

To find a root cause before applying a code fix, follow a four-phase debugging workflow that guides evidence collection, pattern analysis, and hypothesis testing with mandatory checkpoint approvals and evidentiary reporting.

Can I use this structured debugging process for unexpected production issues?▼

Yes, you can use this structured debugging process for unexpected production issues, failing tests, and any unpredictable behavior by initiating a four-phase investigation with mandatory approval gates before each step.

What's the best way to debug software issues without causing unnecessary rework?▼

The best way to debug software issues without rework is to use an approval-gated workflow that enforces root cause identification, iterative hypothesis testing, and comprehensive evidence reporting before implementing fixes.

How does hypothesis testing work during a root cause investigation?▼

Hypothesis testing during a root cause investigation works by iteratively validating assumptions through evidence collection and pattern analysis, with rollback and re-analysis options available at each checkpoint before proceeding to implementation.

When should I not use a four-phase debugging workflow with mandatory approvals?▼

You should not use a four-phase debugging workflow with mandatory approvals for urgent fixes requiring immediate deployment, as the explicit checkpoint verification and evidentiary reporting process intentionally slows down implementation.