ReddRadar
Agent skill
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes. Requires root cause investigation first.
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/methodologies/superpowers/skills/systematic-debugging
SKILL.md
Systematic Debugging
Overview
Random fixes waste time and create new bugs. ALWAYS find root cause before attempting fixes.
Core principle: No fixes without root cause investigation first.
The Four Phases
- Root Cause Investigation - Read errors, reproduce, check changes, gather evidence at component boundaries
- Pattern Analysis - Find working examples, compare against references, identify differences
- Hypothesis and Testing - Form single hypothesis, test minimally, one variable at a time
- Implementation - Create failing test case, implement single fix, verify
When 3+ Fixes Fail
Stop and question the architecture. Pattern of repeated failures indicates architectural problems, not implementation bugs.
Red Flags (STOP and Follow Process)
- "Quick fix for now"
- "Just try changing X"
- Proposing solutions before tracing data flow
- "One more fix attempt" (when already tried 2+)
Agents Used
- Process agents defined in
systematic-debugging.js
Tool Use
Invoke via babysitter process: methodologies/superpowers/systematic-debugging
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
a5c-ai/babysitter
gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
a5c-ai/babysitter
model-profile-resolution
Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.
a5c-ai/babysitter
verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
a5c-ai/babysitter
state-management
STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.
a5c-ai/babysitter
git-integration
Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.
a5c-ai/babysitter
frontmatter-parsing
YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.
Didn't find tool you were looking for?