Subagent crash: classifyHandoffIfNeeded is not defined
Resolved 💬 3 comments Opened Feb 5, 2026 by EtanHey Closed Feb 9, 2026
Bug Report
Version
Claude Code 2.1.32, macOS Darwin 24.6.0
Description
Subagents launched via the Task tool consistently crash with error:
classifyHandoffIfNeeded is not defined
Reproduction
- Launch a subagent using the Task tool (subagent_type: "Explore" or "general-purpose")
- Agent runs successfully for 30-70+ tool calls
- Agent crashes with
classifyHandoffIfNeeded is not defined - Task status shows as "failed"
Frequency
- Happens on ~80% of long-running subagents (30+ tool uses)
- Shorter agents sometimes complete before the crash
- Observed across multiple sessions over 2 days (2026-02-05 to 2026-02-06)
- All agent types affected: Explore, general-purpose, Plan
Context
- Parent session is on
claude-opus-4-6model - Subagents use
claude-sonnet-4-5-20250929(specified viamodel: "sonnet") - Agents are doing read-only operations (Glob, Grep, Read, Bash for
ls/which) - No file writes or destructive operations
- Error appears to be in internal message classification/routing, not in tool execution
Workaround
Work directly in the parent session instead of delegating to subagents.
Example Agent IDs (from one session)
a386763- "Audit current skills organization" - failed after ~55 toolsa71b4e5- "Analyze EmailGolem current capabilities" - failed after ~32 toolsa3c60c7- "Analyze Zikaron as plugin candidate" - failed after ~50 toolsab3a02d- "Audit plan items already done" - failed earlier in session
All failed with identical error: classifyHandoffIfNeeded is not defined
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗