go-agent/claude/code/commands/debug.md
Snider 61e01bfdf1 feat: initial go-agent — agentci + jobrunner + plugins marketplace
Consolidates three codebases into a single agent orchestration repo:

- agentci (from go-scm): Clotho dual-run verification, agent config,
  SSH security (sanitisation, secure commands, token masking)
- jobrunner (from go-scm): Poll-dispatch-report pipeline with 7 handlers
  (dispatch, completion, auto-merge, publish draft, dismiss reviews,
  send fix command, tick parent epic)
- plugins marketplace (from agentic/plugins): 27 Claude/Codex/Gemini
  plugins with shared MCP server

All 150+ tests passing across 6 packages.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 15:47:19 +00:00

645 B

name description
debug Systematic debugging workflow

Debugging Protocol

Step 1: Reproduce

  • Run the failing test/command
  • Note exact error message
  • Identify conditions for failure

Step 2: Isolate

  • Binary search through changes (git bisect)
  • Comment out code sections
  • Add logging at key points

Step 3: Hypothesize

Before changing code, form theories:

  1. Theory A: ...
  2. Theory B: ...

Step 4: Test Hypotheses

Test each theory with minimal investigation.

Step 5: Fix

Apply the smallest change that fixes the issue.

Step 6: Verify

  • Run original failing test
  • Run full test suite
  • Check for regressions