task-system

Task System

Experimental: Agent teams are disabled by default. Enable with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS in your settings.json or environment.

Manage shared work items with dependencies, ownership, and status tracking across agent teams.

Related skills:

• Orchestrating - Primitives overview and quick reference
• Team Management - Creating and managing teams
• Messaging - Communicating about task progress
• Orchestration Patterns - Patterns that use tasks effectively
• Error Handling - Handling task failures

---

TaskCreate - Create Work Items

TaskCreate({
  subject: "Review authentication module",
  description: "Review all files in app/services/auth/ for security vulnerabilities",
  activeForm: "Reviewing auth module..."  // Shown in spinner when in_progress
})

Fields:

• subject - Brief, actionable title in imperative form (e.g., "Fix authentication bug")
• description - Detailed description with context and acceptance criteria
• activeForm - Present continuous form shown while task is in_progress (e.g., "Fixing authentication bug")

All tasks are created with status pending and no owner.

---

TaskList - See All Tasks

TaskList()

Returns summary of each task:

#1 [completed] Analyze codebase structure
#2 [in_progress] Review authentication module (owner: security-reviewer)
#3 [pending] Generate summary report [blocked by #2]

Fields returned:

• id - Task identifier
• subject - Brief description
• status - pending, in_progress, or completed
• owner - Agent name if assigned, empty if available
• blockedBy - List of task IDs that must complete first

When to check: After completing a task, to find newly unblocked work. Prefer tasks in ID order (lowest first) when multiple are available.