debug

Initialize (REQUIRED)

python3 ~/.claude/plugins/agent-swarm/lib/debug_workflow.py start "$ARGUMENTS"

Flow

TRIAGE -> REPRODUCE -> HYPOTHESIZE -> [adversary] -> PROVE -> [adversary] -> FIX -> [adversary] -> VERIFY -> PUSH -> CHECK_STATUS -> DONE

Phases

Phase	Purpose	Allowed	Blocked
TRIAGE	Understand bug context	Read, Glob, Grep, Web	Edit, Write
REPRODUCE	Create failing test	Read, Glob, Grep, Edit, Write, Bash	(test files only)
HYPOTHESIZE	Form root cause theory	Read, Glob, Grep	Edit, Write
PROVE	Verify hypothesis	Read, Glob, Grep, Bash	Edit, Write
FIX	Implement fix	Read, Glob, Grep, Edit, Write, Bash	-
VERIFY	Run tests/lint	Read, Glob, Grep, Bash	Edit, Write
PUSH	Push changes	Bash	-
CHECK_STATUS	Verify CI/reviews	Read, Bash	Edit, Write

Adversary Gates

• HYPOTHESIZE: challenges alternative explanations
• PROVE: verifies prediction confirmed mechanism
• FIX: checks fix addresses proven root cause

Kickback

From	To	Trigger
REPRODUCE	TRIAGE	Can't reproduce
PROVE	HYPOTHESIZE	Prediction not confirmed
VERIFY	PROVE	Tests/lint fail
CHECK_STATUS	PROVE	CI fails or new comments

CLI

python3 lib/debug_workflow.py start "desc"                           # Start
python3 lib/debug_workflow.py status                                 # Status
python3 lib/debug_workflow.py phase                                  # Current phase
python3 lib/debug_workflow.py triage <sev> "<components>" "<artifacts>"  # Record triage
python3 lib/debug_workflow.py hypothesis "<hypothesis>" "<prediction>"   # Record hypothesis
python3 lib/debug_workflow.py verify <tests> <lint>                  # Record (1=pass)
python3 lib/debug_workflow.py advance                                # Next phase
python3 lib/debug_workflow.py stop                                   # Stop