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:
committed by
Steve Yegge
parent
d2a6ddb059
commit
0428922697
@@ -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
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user