Which Fleet Pattern When?

June 10, 2026 · View on GitHub

Pick one primary pattern per organizational pain. Overlapping patterns need coordination — see multi-fleet.md.

flowchart TD
    A[What hurts?] --> B{Don't know what agents exist?}
    B -->|yes| C[Team Agent Registry]
    B -->|no| D{Risky actions without approval?}
    D -->|yes| E[Shared Inbox HITL]
    D -->|no| F{Too many manager/worker handoffs failing?}
    F -->|yes| G[Hierarchical Delegation]
    F -->|no| H{One good agent, many teams want it?}
    H -->|yes| I[Agent Clone & Fork]
    H -->|no| J{Token bill surprise?}
    J -->|yes| K[Fleet Budget Guard]
    J -->|no| L{Compliance / incident review?}
    L -->|yes| M[Cross-Agent Audit]
    L -->|no| C

Quick reference

SymptomPatternStart with
"We have agents everywhere"Team Agent RegistryF1 catalog only
Agents act without oversightShared Inbox HITLF1 approve-only
Manager loop loses track of workersHierarchical DelegationF1 typed handoffs
One agent should serve many teamsAgent Clone & ForkF1 clone policy
Spend growing silentlyFleet Budget GuardF1 caps only
"Who did this?" in incidentCross-Agent AuditF1 read-only audit
  1. Team Agent Registry — inventory what exists
  2. Fleet Budget Guard — caps before scale
  3. Shared Inbox HITL — before any L2+ loops go unattended

Overlap rules

CombinationRule
Registry + anythingRegistry first; no new agents without manifest
Budget Guard + Hierarchical DelegationManager loop inherits team budget; workers inherit sub-caps
Clone & Fork + RegistryClones must register as new IDs with forked_from
Audit + InboxInbox approvals are audit events — link IDs

Prerequisite

If you do not yet have stable loops, start with loop-engineering first. Fleet patterns assume at least one loop pattern is understood.