@tmustier/pi-agent-teams 0.4.0-beta.3 → 0.5.0

package/skills/agent-teams/SKILL.md

@@ -39,16 +39,19 @@ Use the **`teams` tool** (LLM-callable) for delegation, task/messaging mutations
 | `task_set_status` | `taskId`, `status` | `pending` \| `in_progress` \| `completed`. |
 | `task_dep_add` / `task_dep_rm` | `taskId`, `depId` | Dependency graph edits. |
 | `task_dep_ls` | `taskId` | Dependency/block inspection. |
-| `message_dm` | `name`, `message` | Mailbox DM. |
-| `message_broadcast` | `message` | Mailbox broadcast. |
+| `message_dm` | `name`, `message` | Mailbox DM. `urgent=true` interrupts active turns. |
+| `message_broadcast` | `message` | Mailbox broadcast. `urgent=true` interrupts active turns. |
 | `message_steer` | `name`, `message` | RPC steer for running teammate. |
 | `member_spawn` | `name` | Supports context/workspace/model/thinking/plan options. |
 | `member_shutdown` | `name` or `all=true` | Graceful mailbox shutdown request. |
 | `member_kill` | `name` | Force-stop RPC teammate. |
 | `member_prune` | _(none)_ | Mark stale workers offline (`all=true` to force). |
+| `team_done` | _(none)_ | End team run: stop teammates, hide widget (`all=true` to force with in-progress tasks). |
 | `plan_approve` / `plan_reject` | `name` | Resolve pending plan approvals (`feedback` optional for reject). |
 | `hooks_policy_get` | _(none)_ | Read team hooks policy (configured + effective). |
 | `hooks_policy_set` | one or more: `hookFailureAction`, `hookMaxReopensPerTask`, `hookFollowupOwner` | Update team hooks policy at runtime (`hooksPolicyReset=true` clears team overrides first). |
+| `model_policy_get` | _(none)_ | Inspect teammate model policy and current leader inheritance behavior. |
+| `model_policy_check` | optional `model` | Validate a model override before spawn (`<provider>/<modelId>` or `<modelId>`). |
 
 Examples:
 
@@ -57,10 +60,14 @@ teams({ action: "delegate", tasks: [{ text: "Implement auth", assignee: "alice"
 teams({ action: "task_assign", taskId: "12", assignee: "alice" })
 teams({ action: "task_dep_add", taskId: "12", depId: "7" })
 teams({ action: "message_broadcast", message: "Sync: finishing this milestone" })
+teams({ action: "message_dm", name: "alice", message: "Stop using lib X, use Y instead", urgent: true })
 teams({ action: "member_kill", name: "alice" })
 teams({ action: "plan_reject", name: "alice", feedback: "Include rollback strategy" })
 teams({ action: "hooks_policy_get" })
 teams({ action: "hooks_policy_set", hookFailureAction: "reopen_followup", hookMaxReopensPerTask: 2, hookFollowupOwner: "member" })
+teams({ action: "model_policy_get" })
+teams({ action: "model_policy_check", model: "openai-codex/gpt-5.1-codex-mini" })
+teams({ action: "team_done" })
 ```
 
 This covers most day-to-day orchestration without slash commands. For nuanced/manual control, use `/team ...` commands directly.
@@ -95,12 +102,16 @@ Teammates auto-claim unassigned, unblocked tasks by default.
 ## Communication
 
 ```
-/team dm <name> <msg...>       # direct message to one teammate
-/team broadcast <msg...>       # message all teammates
-/team send <name> <msg...>     # RPC-based (immediate, for spawned teammates)
+/team dm <name> <msg...>              # direct message to one teammate
+/team dm <name> --urgent <msg...>     # urgent DM — interrupts active turn via steering
+/team broadcast <msg...>              # message all teammates
+/team broadcast --urgent <msg...>     # urgent broadcast — interrupts all active turns
+/team send <name> <msg...>            # RPC-based (immediate, for spawned teammates)
 ```
 
-Teammates can also message each other directly via the `team_message` tool, with the leader CC'd.
+Urgent messages (`--urgent` or `urgent=true` in tool calls) interrupt a teammate's active turn via steering instead of waiting for idle. Use sparingly — only for time-sensitive coordination like "stop using library X, it's broken".
+
+Teammates can also message each other directly via the `team_message` tool (with optional `urgent` flag), with the leader CC'd.
 
 ## Governance modes
 
@@ -135,11 +146,21 @@ Spawning with `plan` restricts the teammate to read-only tools. After producing
 /team shutdown <name>          # graceful shutdown (teammate can reject if busy)
 /team prune [--all]            # hide stale manual teammates (mark offline in config)
 /team kill <name>              # force-terminate one RPC teammate
-/team cleanup [--force]        # delete team directory after all teammates stopped
+/team done [--force]           # end run: stop teammates + hide widget
+/team cleanup [--force]        # delete team directory, worktrees, and branches
+/team gc [--dry-run] [--force] [--max-age-hours=N]  # garbage-collect stale team dirs
 ```
 
+When all tasks complete and teammates are idle, the widget shows "All tasks done." with a `/team done` hint.
 Teammates reject shutdown requests when they have an active task. Use `/team kill <name>` to force.
 
+## Cleanup
+
+Worktrees and branches are automatically cleaned up on session shutdown and session switch. For manual cleanup:
+
+- `/team cleanup [--force]` — removes the current team directory, including git worktrees and associated branches. Reports removal counts.
+- `/team gc [--dry-run] [--force] [--max-age-hours=N]` — garbage-collects stale team directories older than `N` hours (default: 24). Skips teams with online members or in-progress tasks. Use `--dry-run` to preview.
+
 ## Other commands
 
 ```