convoy-management

Create, track, and land convoys of related beads as primary work orders in the Gas Town multi-agent orchestration framework.

509 stars

bya5c-ai

View on GitHub Installation ↓

Best use case

convoy-management is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Create, track, and land convoys of related beads as primary work orders in the Gas Town multi-agent orchestration framework.

Teams using convoy-management should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/convoy-management/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/methodologies/gastown/skills/convoy-management/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/convoy-management/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How convoy-management Compares

Feature / Agent	convoy-management	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Create, track, and land convoys of related beads as primary work orders in the Gas Town multi-agent orchestration framework.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Convoy Management

## Overview

Manage the full lifecycle of Gas Town convoys: creation from a goal, bead decomposition, agent assignment, progress tracking, and landing (merge). Convoys are the primary work-order unit wrapping related beads.

## When to Use

- Starting a new multi-agent work effort
- 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`

Related Skills

translation-management

509

from a5c-ai/babysitter

Integration with translation management systems and i18n workflows. Connect with Crowdin, Transifex, Weblate, manage translation memory, synchronize glossaries, and automate localization pipelines.

key-management-orchestrator

509

from a5c-ai/babysitter

Cryptographic key lifecycle management orchestration including generation, rotation, and destruction across key management systems

ip-core-management

509

from a5c-ai/babysitter

Vendor IP core configuration and integration expertise for FPGA designs

donor-relationship-management

509

from a5c-ai/babysitter

Cultivate and steward donor relationships including prospect research, personalized engagement strategies, gift acknowledgment, and impact reporting

change-management

509

from a5c-ai/babysitter

Skill for engineering change request and order processing through PLM systems

stormwater-management

509

from a5c-ai/babysitter

Skill for integrated stormwater management and green infrastructure design with SWMM modeling, hydrologic analysis, BMP sizing, and MS4 permit compliance.