samwang0723/team-stop

Team Stop — Clean Up Agent Team

Syntax

/team-stop <team-name>

Steps

1. Verify Completion

1. Read .claude/tasks/{slug}/_status.md.
2. Check phase — warn if not DONE or COMPLETED.
3. Check all dev-{N}.md reports exist.
4. List any incomplete tasks.

2. Confirm with Master

Present what will be cleaned up:

## Team Cleanup: {slug}

Resources to remove:
- Team config: ~/.claude/teams/{slug}/
- Worktrees: .worktrees/{slug}/dev-{1..N}/
- Branches: {slug}/dev-{1..N}

Resources to KEEP:
- Task docs: .claude/tasks/{slug}/*.md
- Integrate branch: {slug}/integrate (if exists)

Proceed? (awaiting confirmation)

3. Clean Up (after Master confirms)

1. Load TeamDelete tool (via ToolSearch) → delete team config.
2. Check for uncommitted changes in each worktree before removal:

   cd .worktrees/{slug}/dev-{N} && git status --porcelain
   

   If any worktree has uncommitted changes, warn Master and list the affected files. Do NOT proceed with removal until Master confirms it is safe to discard or commits are made.
3. Remove worktrees:

   git worktree remove .worktrees/{slug}/dev-{N} --force
   

4. Delete dev branches:

   git branch -D {slug}/dev-{N}
   

5. Remove empty worktree directories.
6. Update _status.md:
   • Worktrees → (cleaned up {date})
   • Add note: "Team disbanded. Task docs preserved."
7. Sometimes TeamDelete not working and sub-agent not responding, Kill all idle agent tmux panes but leave the main session intact. List tmux panes, identify agent/teammate panes, and kill them individually:

   # Kill agent panes (NOT the main session pane)
   tmux list-panes -a -F '#{pane_id} #{pane_title}' | grep -i 'teammate\|agent\|dev-' | awk '{print $1}' | xargs -I{} tmux kill-pane -t {}
   

4. Report

## Team Cleaned Up: {slug}
- Removed: {N} worktrees, {N} branches, team config
- Preserved: .claude/tasks/{slug}/ (all reports)
- Integrate branch: {kept/removed} based on merge status

NEVER auto-clean without Master confirmation.

Team: $ARGUMENTS