convoy-management

---

name: convoy-management description: Create, track, and land convoys of related beads as primary work orders in the Gas Town multi-agent orchestration framework. allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, Agent, AskUserQuestion graph: domains: [domain:software-engineering] skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop] workflows: [workflow:feature-development] topics: [topic:developer-experience] roles: [role:tech-lead, role:backend-engineer]

• Coordinating parallel bead execution across agents
• Tracking progress of distributed work
• Landing (merging) completed convoy results

Process

1. Create convoy from goal or MEOW decomposition
2. Decompose into beads (persistent) and wisps (ephemeral)
3. Assign beads to Crew (long-lived) or Polecats (transient)
4. Track progress via hooks and heartbeats
5. Verify all beads complete with quality checks
6. 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 convoys
• agents/crew-lead/ - Persistent collaborator on beads
• agents/polecat/ - Transient worker for individual beads

Tool Use

Invoke via babysitter process: methodologies/gastown/gastown-convoy