mayor-worker-pattern

What problem does it solve?

The Mayor-Worker pattern solves coordination collapse in large multi-agent systems by clearly separating planning (Mayor) from execution (Workers), ensuring isolated tasks and controlled information flow.

Core Features & Use Cases

• Two-tier architecture: Mayor coordinates work at a global level while workers execute single tasks in isolated environments.
• Fault isolation: Workers are ephemeral and stateless, reducing cross-task contamination and simplifying recovery.
• Controlled coordination: External ledger-based handoff ensures traceability and prevents direct inter-worker communication.
• Use Case: Deploy this pattern when orchestrating 3+ agents on related projects to improve reliability and scalability.

Quick Start

Set up a Mayor-Worker pattern with a Mayor dispatching a single worker task and monitoring the ledger for results.