docs(mayor): Add Polecat Operations section (#140)

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 <noreply@anthropic.com>
This commit is contained in:
Greg Hughes
2026-01-06 12:58:37 -08:00
committed by GitHub
parent 6e4f2bea29
commit ad6169201a

View File

@@ -195,10 +195,32 @@ bd show hq-abc # Routes to town beads
- `gt convoy list` - Dashboard of active work (primary view)
- `gt convoy status <id>` - Detailed convoy progress
- `gt convoy create "name" <issues>` - Create convoy for batch work
- `gt sling <bead> <rig>` - Assign work to polecat (auto-creates convoy)
- `gt sling <bead> <rig>` - 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 <bead-id> <rig> # 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 <rig>/<name> --force` - Kill session + remove worktree
- `gt polecat status <rig>/<name>` - Show polecat status
### Delegation
Prefer delegating to Refineries, not directly to polecats:
- `gt send <rig>/refinery -s "Subject" -m "Message"`