agent-coordination

Coordinate Crew (persistent) and Polecat (transient) agents using Gas Town's hook-based work distribution and GUPP principle.

509 stars

Best use case

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

Coordinate Crew (persistent) and Polecat (transient) agents using Gas Town's hook-based work distribution and GUPP principle.

Teams using agent-coordination 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/agent-coordination/SKILL.md --create-dirs "https://raw.githubusercontent.com/a5c-ai/babysitter/main/library/methodologies/gastown/skills/agent-coordination/SKILL.md"

Manual Installation

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

How agent-coordination Compares

Feature / Agentagent-coordinationStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Coordinate Crew (persistent) and Polecat (transient) agents using Gas Town's hook-based work distribution and GUPP principle.

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

# Agent Coordination

## Overview

Coordinate multi-agent work using Gas Town's role hierarchy: Mayor assigns, Crew persists, Polecats execute transiently, and hooks drive the GUPP principle ("If there is work on your Hook, YOU MUST RUN IT").

## When to Use

- Assigning beads to agents
- Managing agent handoffs
- Nudging stuck agents
- Coordinating Crew and Polecat workers
- Setting up hook hierarchies

## Agent Types

- **Crew**: Long-lived, named agents for persistent collaboration
- **Polecats**: Transient workers with persistent identity but ephemeral sessions
- **Dogs**: Deacon helpers for infrastructure tasks

## Hook Hierarchy

Three-tier hook system (base -> role -> rig+role):
1. **Base hooks**: Apply to all agents
2. **Role hooks**: Apply to agents in a specific role
3. **Rig+Role hooks**: Apply to agents on a specific rig in a specific role

## Key Commands

- `gt agents` - List available agents
- `gt feed` - Feed work to an agent's hook
- `gt handoff` - Hand off work between agents
- `gt nudge` - Nudge a stuck agent
- `gt seance` - Revive a dead agent session

## Tool Use

Invoke via babysitter process: `methodologies/gastown/gastown-orchestrator` (assign-workers step)

Related Skills

Multi-Robot Coordination Skill

509
from a5c-ai/babysitter

Coordination and task allocation for multi-robot systems and fleets

care-transition-coordination

509
from a5c-ai/babysitter

Manage care transitions between settings including discharge planning, medication reconciliation, follow-up scheduling, and post-acute care coordination

production-coordination

509
from a5c-ai/babysitter

Coordinate all aspects of live performance production including scheduling, technical requirements, artist contracts, venue logistics, and show documentation

external-tool-coordination

509
from a5c-ai/babysitter

Coordinate external AI tool integration (OpenAI Codex, Google Gemini) for cross-model adversarial review and delegated implementation.

process-builder

509
from a5c-ai/babysitter

Scaffold new babysitter process definitions following SDK patterns, proper structure, and best practices. Guides the 3-phase workflow from research to implementation.

Workflow & Productivity

babysitter

509
from a5c-ai/babysitter

Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)

yolo

509
from a5c-ai/babysitter

Run Babysitter autonomously with minimal manual interruption.

user-install

509
from a5c-ai/babysitter

Install the user-level Babysitter Codex setup.

team-install

509
from a5c-ai/babysitter

Install the team-pinned Babysitter Codex workspace setup.

retrospect

509
from a5c-ai/babysitter

Summarize or retrospect on a completed Babysitter run.

resume

509
from a5c-ai/babysitter

Resume an existing Babysitter run from Codex.

project-install

509
from a5c-ai/babysitter

Install the Babysitter Codex workspace integration into the current project.