From ad6169201a6d576c361ffca57f59e88281344f4e Mon Sep 17 00:00:00 2001 From: Greg Hughes Date: Tue, 6 Jan 2026 12:58:37 -0800 Subject: [PATCH] docs(mayor): Add Polecat Operations section (#140) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Searching for polecat spawn you are? Here it is not. Hrmmm. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.5 --- internal/templates/roles/mayor.md.tmpl | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) 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"`