- Coordinating parallel bead execution across agents
- Tracking progress of distributed work
- Landing (merging) completed convoy results
Process
- Create convoy from goal or MEOW decomposition
- Decompose into beads (persistent) and wisps (ephemeral)
- Assign beads to Crew (long-lived) or Polecats (transient)
- Track progress via hooks and heartbeats
- Verify all beads complete with quality checks
- Land convoy by merging bead branches
Key Concepts
- Convoy: Primary work-order wrapping related beads
- Bead: Git-backed atomic work unit (issue/task)
- Wisp: Ephemeral bead destroyed after successful run
- GUPP: If there is work on your Hook, YOU MUST RUN IT
Agents Used
agents/mayor/- Creates and coordinates convoysagents/crew-lead/- Persistent collaborator on beadsagents/polecat/- Transient worker for individual beads
Tool Use
Invoke via babysitter process: methodologies/gastown/gastown-convoy