team-management

name: team-management description: Use when admin requests creating a team, importing a team, managing team composition, adding/removing workers from a team, or delegating tasks to a Team Leader.

Team Management

A Team consists of 1 Team Leader + N Workers. The Team Leader is a special Worker with management skills that handles task decomposition and assignment within the team. Manager delegates tasks to Team Leaders, not directly to team workers.

Quick Create (2 steps)

# 1. Create team via hiclaw CLI
hiclaw create team \
  --name <TEAM_NAME> \
  --leader-name <LEADER_NAME> \
  --leader-model <MODEL> \
  --workers <w1>,<w2>

# 2. @mention the Leader in Leader Room to assign task

After creation, the Leader is online in the Leader Room (Manager + Global Admin + Leader). @mention the Leader there to delegate the task — the Leader will decompose it and coordinate with team workers in the Team Room.

Full workflow: read references/create-team.md

Gotchas

• Team Leader is a Worker container — same runtime, but with team-leader-agent skills instead of worker-agent skills
• Team workers only talk to their Leader — their groupAllowFrom has [Leader, Team Admin], NOT Manager
• Manager only talks to Team Leader — never @mention team workers directly
• Team Room includes Team Admin — it's Leader + Team Admin + all team workers (no Global Admin unless they are Team Admin)
• Leader Room is standard 3-party — Manager + Global Admin + Leader (same as regular worker room)
• Leader DM is Team Admin ↔ Leader — for team-level management
• Team Admin defaults to Global Admin — if --team-admin not specified
• Delegated tasks use --delegated-to-team — so heartbeat knows to check with Leader, not workers
• Controller forces runtime: copaw for all team members — omit runtime from team creation

Operation Reference