docs: Make documentation convoy-first (gt-yg8bs)

Update all documentation to present convoy as the primary unit of work tracking:

- README.md: Show convoy create before sling in Quick Start and Workflows
- reference.md: Reorder to show Convoy Management before Work Assignment
- understanding-gas-town.md: Add convoy to dispatch workflow example
- mayor.md.tmpl: Add convoy commands to Work Management section
- crew.md.tmpl: Include convoy in dispatch workflow table

Convoy is now the standard workflow - all slings should be part of a convoy.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
gastown/polecats/rictus
2025-12-31 13:14:26 -08:00
committed by Steve Yegge
parent d2a6ddb059
commit 0428922697
5 changed files with 45 additions and 19 deletions

View File

@@ -214,24 +214,29 @@ gt rig list
gt rig remove <name>
```
### Work Assignment
```bash
gt sling <bead> <rig> # Assign to polecat
gt sling <bead> <rig> --molecule=<proto>
```
### Convoy Management (Work Tracking)
### Convoy Management (Primary Dashboard)
```bash
gt convoy list # Dashboard of active convoys
gt convoy status [convoy-id] # Show progress (🚚 hq-cv-*)
gt convoy create "name" [issues...] # Create convoy tracking issues
gt convoy create "name" gt-a bd-b --notify mayor/ # With notification
gt convoy status [convoy-id] # Show progress (🚚 hq-cv-*)
gt convoy list # Dashboard of active convoys
gt convoy list --all # Include landed convoys
gt convoy list --status=closed # Only landed convoys
```
Note: "Swarm" is ephemeral (workers on a convoy's issues). See [Convoys](convoy.md).
### Work Assignment
```bash
# Standard workflow: convoy first, then sling
gt convoy create "Feature X" gt-abc gt-def
gt sling gt-abc <rig> # Assign to polecat
gt sling gt-def <rig> --molecule=<proto> # With workflow template
# Quick sling (auto-creates convoy)
gt sling <bead> <rig> # Auto-convoy for dashboard visibility
```
### Communication
```bash
gt mail inbox

View File

@@ -138,7 +138,8 @@ For work that should be owned by the target rig:
# Create issue in target rig
bd create --prefix beads "Fix authentication bug"
# Sling to target rig's workers
# Create convoy and sling to target rig
gt convoy create "Auth fix" bd-xyz
gt sling bd-xyz beads
```