claude-code - 💡(How to fix) Fix [Bug] Claude Code creates single Agent instead of Team when explicitly requested

Bug Description I asked CC to create an agent team and it spawned a fg sub-agent instead

Prompt: "Let's create an agent team. How about one sonnet page editor who actually edits the report file to start with. First let's ask it, let's adjust the format because the confidence column in all of the per option tables..."

Later debugging: """ Debug: Why didn't you use TeamCreate when I asked you to create an agent team?

● Honest debug:

1. Pattern-matched to the familiar tool. "Create an agent team" → I jumped to Agent (already loaded, used dozens of times) and treated "team" as flavor text. I gave the agent a name parameter, which scratched the "addressable later" itch and let me feel like I'd built something team-shaped without actually doing so.
2. Ignored a clear signal. TeamCreate, TeamDelete, and SendMessage were all listed as deferred tools in the system reminder. The existence of TeamCreate as a distinct primitive should have told me "team" had a technical meaning in this harness. I didn't pause to check.
3. Friction avoidance. TeamCreate's schema wasn't loaded — using it required a ToolSearch call first. Agent was already loaded. Small cost, but I took the shortcut.
4. No verification step. I didn't ask "is there a team primitive?" or grep my own tool list. The whole c-research skill exists in part because I'm bad at this kind of self-check, and the same gap applied here.

Root cause: I treated your phrasing as approximate when it was precise. You said "team," there's a TeamCreate tool, I should have loaded its schema and used it. """

Environment Info

• Platform: linux
• Terminal: gnome-terminal
• Version: 2.1.143
• Feedback ID: 05f1e634-6f54-4032-9f00-27185c68faae

Errors

[{"error":"MaxFileReadTokenExceededError: [REDACTED] content (33290 tokens) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of the file, or search for specific content instead of reading the whole file.\n    at IH4 (/$bunfs/root/src/entrypoints/cli.js:4948:13303)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-05-16T14:16:29.041Z"}]