TaskCreate, TaskList, TaskUpdate tools referenced in TeamCreate docs but not available at runtime
Description
The TeamCreate tool documentation (part of the system prompt) explicitly references TaskCreate, TaskList, and TaskUpdate as available tools for team coordination:
"2. Create tasks using the Task tools (TaskCreate, TaskList, etc.) — they automatically use the team's task list" "4. Assign tasks using TaskUpdate with owner to give tasks to idle teammates" "5. Teammates work on assigned tasks and mark them completed via TaskUpdate"
These tools do not exist at runtime — not for the main session, not for spawned agents (general-purpose with "Tools: *"), and not as deferred tools via ToolSearch.
Environment
- Claude Code v2.1.34 (also tested on 2.1.32)
- VSCode extension
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSis set to"1"in~/.claude/settings.jsonTeamCreate,TeamDelete, andSendMessageall work — only the task management tools are missing
Steps to Reproduce
- Enable experimental agent teams:
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } } - Create a team with
TeamCreate— works, creates~/.claude/teams/{name}/and~/.claude/tasks/{name}/ - Attempt to call
TaskCreateto populate the task board — tool does not exist - Search via
ToolSearchfor TaskCreate, TaskList, TaskUpdate — no results - Spawned general-purpose agents ("Tools: *") also cannot find these tools
Impact
The TeamCreate documentation describes a task board coordination workflow (create tasks → assign to agents → agents claim and complete tasks → dependency gating). This is the core orchestration mechanism for agent teams. Without TaskCreate/TaskList/TaskUpdate, there is no way to use the task board that TeamCreate itself sets up.
The team infrastructure directory (~/.claude/tasks/{team-name}/) gets created but has no tool-based interface to populate or read it. The only coordination available is SendMessage for peer-to-peer messaging, which works but is a fundamentally different (and less capable) coordination model than what the documentation describes.
Expected Behavior
TaskCreate, TaskList, and TaskUpdate should be available as tools when CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS is enabled, matching the TeamCreate documentation.
Workaround
Currently none that preserves the documented task board workflow. Agents can coordinate through SendMessage and prompt-based instructions, but without the task tools there is no shared task board, no dependency gating, and no self-coordination.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗