agent/codex/code/commands/debug.md
Snider e90a84eaa0 feat: merge go-agent + go-agentic + php-devops into unified agent repo
Combines three repositories into a single workspace:
- go-agent → pkg/orchestrator (Clotho), pkg/jobrunner, pkg/loop, cmd/
- go-agentic → pkg/lifecycle (allowance, sessions, plans, dispatch)
- php-devops → repos.yaml, setup.sh, scripts/, .core/

Module path: forge.lthn.ai/core/agent

All packages build, all tests pass.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 15:23:00 +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