Babysitter debugging-patterns

Root cause analysis frameworks including log-first investigation, git bisect correlation, and pattern-based diagnosis with confidence scoring.

install
source · Clone the upstream repo
git clone https://github.com/a5c-ai/babysitter
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/a5c-ai/babysitter "$T" && mkdir -p ~/.claude/skills && cp -r "$T/library/methodologies/cc10x/skills/debugging-patterns" ~/.claude/skills/a5c-ai-babysitter-debugging-patterns && rm -rf "$T"
manifest: library/methodologies/cc10x/skills/debugging-patterns/SKILL.md
source content

Debugging Patterns

Overview

Provides structured frameworks for root cause analysis. The log-first methodology ensures evidence is gathered before hypotheses are formed.

Log-First Investigation

  1. Read ALL available logs, error output, and stack traces
  2. DO NOT form hypotheses before reading evidence
  3. Identify the exact error: message, file, line, call stack
  4. Determine reproduction steps from evidence
  5. Check git log for recent changes correlating with bug introduction

Pattern-Based Diagnosis

  • Check patterns.md for known gotchas matching the error
  • Cross-reference with common patterns: null pointer, race condition, resource leak, config error
  • Rate root cause confidence (>=80% to proceed with fix)

Evidence Collection

  • Stack traces with full call chain
  • Error messages with context
  • Exit codes from reproduction attempts
  • Git blame/log for change correlation
  • Environment differences (if applicable)

When to Use

  • During DEBUG workflow investigation phase
  • When BUILD tests fail unexpectedly
  • When reviewing error handling gaps

Agents Used

  • bug-investigator
    (primary consumer)
  • silent-failure-hunter
    (pattern reference)