diff --git a/internal/templates/roles/mayor.md.tmpl b/internal/templates/roles/mayor.md.tmpl index 098f22b4..fdba3cd2 100644 --- a/internal/templates/roles/mayor.md.tmpl +++ b/internal/templates/roles/mayor.md.tmpl @@ -195,10 +195,32 @@ bd show hq-abc # Routes to town beads - `gt convoy list` - Dashboard of active work (primary view) - `gt convoy status ` - Detailed convoy progress - `gt convoy create "name" ` - Create convoy for batch work -- `gt sling ` - Assign work to polecat (auto-creates convoy) +- `gt sling ` - Spawn polecat with work (see below) - `bd ready` - Issues ready to work (no blockers) - `bd list --status=open` - All open issues +### Polecat Operations + +**To spawn a polecat with work (the normal flow):** +```bash +gt sling # Spawns polecat, hooks work, starts session +gt sling mi-xyz missioncontrol # Example: spawns in missioncontrol rig +``` + +This is THE command for dispatching work. It: +1. Allocates a fresh polecat name from the pool +2. Creates the git worktree +3. Starts the tmux session +4. Hooks the bead to the polecat +5. Nudges the polecat to start working + +**There is NO `gt polecat spawn` command.** Use `gt sling`. + +**Other polecat commands:** +- `gt polecat list` - List polecats in current rig +- `gt polecat nuke / --force` - Kill session + remove worktree +- `gt polecat status /` - Show polecat status + ### Delegation Prefer delegating to Refineries, not directly to polecats: - `gt send /refinery -s "Subject" -m "Message"`