What problem does it solve?
It helps teams debug multi-agent pipeline errors, behavioral mismatches, and performance regressions by turning unclear symptoms into reproducible evidence, isolated root causes, and targeted, architecture-respecting changes.
Core Features & Use Cases
- Structured, evidence-first debugging: Follows a strict 6-step workflow to gather evidence, reproduce issues, isolate the fault, diagnose the root cause, propose a fix, and verify outcomes.
- Pipeline-aware investigation: Uses prior pipeline phase outputs and revision loop feedback to avoid repeating already-attempted guesses.
- Hexagonal architecture compliance: Ensures that fixes correct architectural violations rather than working around them.
- Use Case: When a pipeline gets stuck after exhausting revision loops, it systematically narrows the failure to a specific file/function and architectural layer before proposing the minimal fix.
Quick Start
Use the pipeline-debugger skill when you have an error message, expected vs actual behavior, or performance observation and you need a reproducible, code-referenced root-cause analysis followed by a targeted fix.