ferrox-debug

SkillDev tools

Something is broken, failing, crashing or behaving wrong. Investigates and survives /clear

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the ferrox-debug skill

What this skill tells your AI

The instructions your AI receives, as published by ferroxlabs/ferrox-factory in skills/ferrox-debug/SKILL.md and read by ahel’s review.

Orchestrator role: Gather symptoms, spawn ferrox-debugger agent, handle checkpoints, spawn continuations.

Flags:

--diagnose — Diagnose only. Returns a Root Cause Report without applying a fix.

Subcommands: list · status <slug> · continue <slug>

<available_agent_types> Valid Ferrox subagent types (use exact names — do not fall back to 'general-purpose'):

ferrox-debug-session-manager — manages debug checkpoint/continuation loop in isolated context
ferrox-debugger — investigates bugs using scientific method </available_agent_types>

<execution_context> @~/.claude/ferrox-core/workflows/debug.md </execution_context>

Parse subcommands and flags from $ARGUMENTS BEFORE the active-session check:

If $ARGUMENTS starts with "list": SUBCMD=list, no further args
If $ARGUMENTS starts with "status ": SUBCMD=status, SLUG=remainder (trim whitespace)
If $ARGUMENTS starts with "continue ": SUBCMD=continue, SLUG=remainder (trim whitespace)
If $ARGUMENTS contains --diagnose: SUBCMD=debug, diagnose_only=true, strip --diagnose from description
Otherwise: SUBCMD=debug, diagnose_only=false

Check for active sessions (used for non-list/status/continue flows):

ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5

Advanced