git:20260507.8dfdcb4 to git:20260507.9f5be95

---

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`