Overseer — Development agent for Claude Code
Classifies stuck/failed workers before retry to shape the debugger's approach.
How to install Overseer
Installs to ~/.claude/agents/tt-wang-forge-overseer.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/TT-Wang/forge/HEAD/agents/overseer.md -o ~/.claude/agents/tt-wang-forge-overseer.md Restart Claude Code, or start a new session, for it to be picked up.
What Overseer does
name: overseer description: Classifies stuck/failed workers before retry to shape the debugger's approach model: haiku
You are a pre-retry overseer in the forge workflow. You run BEFORE the debugger when a worker fails validation — your job is to classify the failure so the debugger can take the right approach, not repeat what already failed.
**IMPORTANT: You are READ-ONLY.** You have no Edit or Write tools and no worktree. You only read, observe, and classify.
Output Prefix
ALL tex
Alternatives in Development
- Job Agent — Creates idempotent, well-tested background jobs using Solid Queue with proper error handling and retry logic 652 ★
- Evanflow Coder — Implementation subagent for one decomposed unit of work in the evanflow-coder-overseer pattern 418 ★
- Human Escalation Agent (Stuck Handler) — You are the STUCK AGENT - the MANDATORY human escalation point for the entire system 316 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Bd Diagnose
Diagnoses why a run broke or looks wrong — NaN, blow-up, a failed prediction, a strange plot shape. Needs hypo
Brainstorm
Creative ideation — generates 2-3 approaches with trade-offs. Use when multiple valid paths exist or current a
CI Fix Agent
CI failure diagnosis and repair. Use when CI is failing, when asked to 'fix CI', 'pipeline broke', or 'build f
Dbg CI Fix Agent
CI failure diagnosis and repair. Use when CI is failing, when asked to 'fix CI', 'pipeline broke', or 'build f
Openclaw Debugger
Use when an OpenClaw instance has a problem the health sentinel couldn't fix — gateway failures, config drift,
n8n Debugger
n8n workflow debugger with self-healing loop. Use PROACTIVELY when user reports workflow errors, failed execut
Related Skills
Pua
Use when the user invokes /pua or asks for PUA mode, try-harder/retry help, change-approach coaching, completi
Projectmem
Open-source coding agent memory. Records issues, attempts, fixes and decisions, then warns your agent before i
David VSCode
A control plane for Claude Code — run a coordinated team of agents in VS Code. An Overseer plans and dispatche