team-delegate — Claude Code command: team task distribution
team-delegate displays team workload dashboard, assigns tasks to members, and rebalances load via --assign, --message, and --rebalance flags.
MIT ★ 42,780 updated 2026-10-24
/plugin marketplace add wshobson/agents
/plugin install agent-teams@claude-code-workflowsWhat team-delegate does
The command reads team config from ~/.claude/teams/{team-name}/config.json and current task list to display unassigned tasks, member workloads, blocked tasks, and rebalancing suggestions. The --assign task-id=member-name flag assigns a task to a member and sends a notification. The --rebalance flag analyzes load, identifies overloaded members (3+ tasks) and idle members (0 tasks), and suggests reassignments. Without flags, it outputs the full delegation dashboard.
Requires a configured team in ~/.claude/teams/ and works with built-in TaskList, TaskUpdate, and SendMessage tools. For ad-hoc delegation, Claude Code has a built-in delegate mode accessible via Shift+Tab.
What it helps with
- see who is overloaded and who is idle
- assign a task to a specific member and notify them
- rebalance workload across team members
- find blocked tasks and their dependencies
- send a message to a team member
Example prompts for the agent
- Show delegation dashboard for backend-team
- Assign task 5 to implementer-3 with
/team-delegate backend-team --assign 5=implementer-3 - Analyze team load and suggest rebalancing via
/team-delegate backend-team --rebalance
How to install team-delegate
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install agent-teams@claude-code-workflows2Manually: put the files in place
.claude/commands/team-delegate.mdCall it with /team-delegate. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/team-delegate.mdCall it with /prompts:team-delegate. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/team-delegate.prompt.mdManually: put the files in place
.gemini/commands/team-delegate.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about team-delegate
How to install team-delegate in Claude Code?
Run /plugin marketplace add wshobson/agents, then /plugin install agent-teams@claude-code-workflows. The command will appear in .claude/commands/team-delegate.md.
What does team-delegate do?
The command displays team workload, assigns tasks to members, sends notifications, and suggests load rebalancing based on the current task list.
What does team-delegate require?
It requires a team config file in ~/.claude/teams/{team-name}/config.json. The command uses Claude Code's built-in tools for tasks and messages.
Source text
team-delegate.md · MIT
---
description: "Task delegation dashboard for managing team workload, assignments, and rebalancing"
argument-hint: "[team-name] [--assign task-id=member-name] [--message member-name 'content'] [--rebalance]"
---
# Team Delegate
Manage task assignments and team workload. Provides a delegation dashboard showing unassigned tasks, member workloads, blocked tasks, and rebalancing suggestions.
## Pre-flight Checks
1. Parse `$ARGUMENTS` for team name and action flags:
- `--assign task-id=member-name`: assign a specific task to a member
- `--message member-name 'content'`: send a message to a specific member
- `--rebalance`: analyze and rebalance workload distribution
2. Read team config from `~/.claude/teams/{team-name}/config.json` using the Read tool
3. Call `TaskList` to get current state
## Action: Assign Task
If `--assign` flag is provided:
1. Parse task ID and member name from `task-id=member-name` format
2. Use `TaskUpdate` to set the task owner
3. Use `SendMessage` with `type: "message"` to notify the member:
- recipient: member name
- content: "You've been assigned task #{id}: {subject}. {task description}"
4. Confirm: "Task #{id} assigned to {member-name}"
## Action: Send Message
If `--message` flag is provided:
1. Parse member name and message content
2. Use `SendMessage` with `type: "message"`:
- recipient: member name
- content: the message content
3. Confirm: "Message sent to {member-name}"
## Action: Rebalance
If `--rebalance` flag is provided:
1. Analyze current workload distribution:
- Count tasks per member (in_progress + pending assigned)
- Identify members with 0 tasks (idle)
- Identify members with 3+ tasks (overloaded)
- Check for blocked tasks that could be unblocked
2. Generate rebalancing suggestions:
```
## Workload Analysis
Member Tasks Status
─────────────────────────────────
implementer-1 3 overloaded
implementer-2 1 balanced
implementer-3 0 idle
Suggestions:
1. Move task #5 from implementer-1 to implementer-3
2. Assign unassigned task #7 to implementer-3
```
3. Ask user for confirmation before executing rebalancing
4. Execute approved moves with `TaskUpdate` and `SendMessage`
## Default: Delegation Dashboard
If no action flag is provided, display the full delegation dashboard:
```
## Delegation Dashboard: {team-name}
### Unassigned Tasks
#5 Review error handling patterns
#7 Add integration tests
### Member Workloads
implementer-1 3 tasks (1 in_progress, 2 pending)
implementer-2 1 task (1 in_progress)
implementer-3 0 tasks (idle)
### Blocked Tasks
#6 Blocked by #4 (in_progress, owner: implementer-1)
### Suggestions
- Assign #5 to implementer-3 (idle)
- Assign #7 to implementer-2 (low workload)
```
**Tip**: Use Shift+Tab to enter Claude Code's built-in delegate mode for ad-hoc task delegation.
© Seth Hobson · MIT · wshobson/agents