Subagent fails with 'classifyHandoffIfNeeded is not defined' on task completion
Resolved 💬 3 comments Opened Feb 7, 2026 by aleksey-rezvov Closed Feb 11, 2026
Description
When a subagent (type claude-code-guide) completes its work and attempts to return results to the parent session, it crashes with the error:
classifyHandoffIfNeeded is not defined
Steps to Reproduce
- Start a Claude Code session (version 2.1.34)
- Trigger a Task tool call with
subagent_type: "claude-code-guide"that performs multiple WebFetch calls to documentation pages - The agent successfully gathers data but fails on completion/handoff
Expected Behavior
The subagent should complete successfully and return its results to the parent session.
Actual Behavior
The agent task status is reported as failed with error:
classifyHandoffIfNeeded is not defined
The agent's output buffer still contains the collected data, so the parent session can read partial results, but the task is marked as failed.
Environment
- Claude Code version: 2.1.34
- Platform: Linux 6.8.0-1045-nvidia
- Model: claude-opus-4-6
- Subagent model: claude-haiku-4-5-20251001
Additional Context
The function classifyHandoffIfNeeded appears to be referenced but not defined/imported in the subagent runtime. This seems like a missing dependency or broken import in the agent handoff/completion pathway.
🤖 Generated with Claude Code
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗