convoy-management git:20260507.8dfdcb4C

Immutable. This exact content is served forever at /api/v1/blob/dec8aed129ae59b8.

---
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`