debug

Debug complex systems via four-phase root-cause analysis before fixes.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/mchien15/wrenai --skill debug-mchien15
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/mchien15/wrenai/tree/main/.claude/skills/debug
Command: npx skills add https://github.com/mchien15/wrenai --skill debug-mchien15

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Debug systematically with root cause analysis before fixes. The Iron Law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.

Core Features & Use Cases

  • Four-phase debugging approach: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis Testing, Phase 4 Implementation.
  • Root-Cause Tracing and Defense-in-Depth: trace data flow, validate at multiple layers, and instrument for forensics.
  • Polluter Detection: includes the find-polluter.sh script to bisect tests that create pollution and isolate the responsible test.

Quick Start

Start a full four-phase debugging workflow on the issue, ensuring evidence collection before attempting any fix.

Frequently Asked Questions about debug

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

FAQPage Schema
What is the best way to debug complex software systems and find root causes?

Systematic debugging requires a four-phase process to uncover root causes before applying fixes. This approach traces data flow, validates at multiple layers, and instruments for forensics to resolve code defects and multi-component incidents.

How do I find a polluter test causing test failures in my CI/CD pipeline?

To find a polluter test causing test failures, use a bisection script like find-polluter.sh. This tool bisects test suites to isolate the specific test responsible for creating pollution and causing subsequent failures.

Can I use this systematic debugging approach for CI/CD anomalies and infrastructure incidents?

Yes, systematic debugging applies to CI/CD anomalies and multi-component incidents across server, client, and infrastructure layers. It enforces root-cause investigation and pattern-driven analysis prior to applying any code changes.

How do I investigate test failures without immediately applying fixes?

Investigate test failures by following a structured four-phase approach: root cause investigation, pattern analysis, hypothesis testing, and implementation. This ensures evidence collection and defense-in-depth validation before attempting any fix.

Why should I trace data flow and validate at multiple layers during root cause analysis?

Tracing data flow and validating at multiple layers during root cause analysis ensures defense-in-depth. This systematic process provides verifiable fixes by confirming hypotheses through forensics instrumentation before changing the codebase.

Does this debugging workflow work for code defects across both server and client layers?

Yes, this debugging workflow handles code defects across server, client, and infrastructure layers. It provides pattern-driven analysis guidance to systematically investigate complex multi-component software incidents and anomalies.