agent-coordination

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)