team-shutdown

---
description: "Gracefully shut down an agent team, collect final results, and clean up resources"
argument-hint: "[team-name] [--force] [--keep-tasks]"
---

# Team Shutdown

Gracefully shut down an active agent team by sending shutdown requests to all teammates, collecting final results, and cleaning up team resources.

## Phase 1: Pre-Shutdown

1. Parse `$ARGUMENTS` for team name and flags:
   - If no team name, check for active teams (same discovery as team-status)
   - `--force`: skip waiting for graceful shutdown responses
   - `--keep-tasks`: preserve task list after cleanup

2. Read team config from `~/.claude/teams/{team-name}/config.json` using the Read tool
3. Call `TaskList` to check for in-progress tasks

4. If there are in-progress tasks and `--force` is not set:
   - Display warning: "Warning: {N} tasks are still in progress"
   - List the in-progress tasks
   - Ask user: "Proceed with shutdown? In-progress work may be lost."

## Phase 2: Graceful Shutdown

For each teammate in the team:

1. Use `SendMessage` with `type: "shutdown_request"` to request graceful shutdown
   - Include content: "Team shutdown requested. Please finish current work and save state."
2. Wait for shutdown responses
   - If teammate approves: mark as shut down
   - If teammate rejects: report to user with reason
   - If `--force`: don't wait for responses

## Phase 3: Cleanup

1. Display shutdown summary:

   ```
   Team "{team-name}" shutdown complete.

   Members shut down: {N}/{total}
   Tasks completed: {completed}/{total}
   Tasks remaining: {remaining}
   ```

2. Unless `--keep-tasks` is set, call `TeamDelete` to remove team and task directories

3. If `--keep-tasks` is set, inform user: "Task list preserved at ~/.claude/tasks/{team-name}/"