TaskCreate, TaskList, TaskUpdate tools referenced in TeamCreate docs but not available at runtime

Resolved 💬 1 comment Opened Feb 6, 2026 by jayeshm33-bit Closed Feb 6, 2026

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_TEAMS is set to "1" in ~/.claude/settings.json
  • TeamCreate, TeamDelete, and SendMessage all work — only the task management tools are missing

Steps to Reproduce

  1. Enable experimental agent teams: { "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }
  2. Create a team with TeamCreate — works, creates ~/.claude/teams/{name}/ and ~/.claude/tasks/{name}/
  3. Attempt to call TaskCreate to populate the task board — tool does not exist
  4. Search via ToolSearch for TaskCreate, TaskList, TaskUpdate — no results
  5. 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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗