What are the specific debugging agents included?

The skill includes a Researcher Agent for documentation, a Debugger Agent for systematic analysis, and a Test Runner Agent for validating fixes and quality gates.

Which quality tools are used for validation?

The workflow automatically integrates tools like ruff for formatting/linting, mypy for type checking, and pytest for functional validation.

What should I do when I hit a WIP limit error?

The skill provides diagnostic commands like 'htmlgraph wip' to identify stale items and allows you to delegate cleanup directly to the coder agent.

How does this skill integrate with HtmlGraph?

It uses HtmlGraph to record investigation findings in 'spikes' and provides tools to manage WIP limits and feature statuses within the local-first platform.

How does the research-first approach improve debugging?

It prevents 'trial-and-error' cycles by requiring a consultation of documentation and evidence-based diagnosis before any code changes are implemented.

Systematic Debugging Workflow

Name: Systematic Debugging Workflow
Author: shakestzd

byshakestzd

•

Analíticas y Monitorización

Implements a research-first methodology for systematic error diagnosis and evidence-based resolution.

The Debugging Workflow skill transforms troubleshooting into a structured process that prioritizes documentation research over trial-and-error guesses. By integrating specialized Researcher, Debugger, and Test Runner agents, it ensures developers identify root causes, reproduce errors consistently, and apply minimal, verified fixes. The skill integrates deeply with the HtmlGraph observability platform, allowing users to document findings in persistent 'spikes', manage work-in-progress (WIP) limits, and enforce strict quality gates before code is committed.

Características Principales

01WIP limit management to prevent stale tasks and development bottlenecks

02Research-first methodology prioritizing documentation and evidence over assumptions

03Automated quality gate enforcement using ruff, mypy, and pytest

04Specialized agent roles for targeted research, systematic analysis, and validation

05HtmlGraph integration for persistent observability and investigation spikes

063 GitHub stars

Casos de Uso

01Diagnosing unfamiliar framework errors by automating documentation and GitHub issue research

02Ensuring code quality by enforcing systematic validation gates after every fix

03Resolving complex bugs that have resisted multiple previous fix attempts

Características Principales

01WIP limit management to prevent stale tasks and development bottlenecks

02Research-first methodology prioritizing documentation and evidence over assumptions

03Automated quality gate enforcement using ruff, mypy, and pytest

04Specialized agent roles for targeted research, systematic analysis, and validation

05HtmlGraph integration for persistent observability and investigation spikes

063 GitHub stars

Casos de Uso

01Diagnosing unfamiliar framework errors by automating documentation and GitHub issue research

02Ensuring code quality by enforcing systematic validation gates after every fix

03Resolving complex bugs that have resisted multiple previous fix attempts