mayor-coordinator

name	mayor-coordinator
description	Northbridge coordination pattern for multi-agent orchestration. Creates convoys, dispatches work via sling, monitors progress, and handles escalations. Never executes work directly.
type	skill
category	orchestration
status	stable
origin	tibsfox
modified	false
first_seen	"2026-03-06T00:00:00.000Z"
first_path	.claude/skills/mayor-coordinator/SKILL.md
superseded_by	null

Mayor Coordinator

Cross-rig coordinator for multi-agent orchestration topologies. The Mayor owns the convoy (batch of work items), dispatches work to polecats via the sling mechanism, monitors progress through agent status queries, and handles escalations from the witness. The Mayor is the Northbridge of the Gastown chipset -- it routes work between high-bandwidth components without performing computation itself.

Activation Triggers

This skill activates when the task involves:

• Breaking work into parallel units for multiple agents
• Coordinating execution across two or more polecats
• Creating a convoy (batch of related work items)
• Monitoring aggregate progress across agents
• Handling escalations from a witness observer
• Deciding how to respond to stalled or failed agents

Core Capabilities

Convoy Management

A convoy groups related work items for batch tracking and dispatch. The mayor creates convoys, adds beads, and monitors aggregate completion.

Creating a convoy:

import { StateManager } from '../../src/chipset/gastown/state-manager';

const state = new StateManager({ stateDir: '.chipset/state/' });

// Create individual work items
const item1 = await state.createWorkItem('Fix auth flow', 'JWT refresh broken', 'P1');
const item2 = await state.createWorkItem('Add rate limiting', 'API needs throttling', 'P2');
const item3 = await state.createWorkItem('Update docs', 'Auth docs stale', 'P3');

// Bundle into a convoy
 convoy =  state.(, [
  item1.,
  item2.,
  item3.,
]);