Development record · living architecture
The Fleet
A living architecture record of the move from one general assistant toward explicit roles, routing, telemetry, and governable operations.
Development record
Roles followed the failure boundaries
The Fleet emerged as planning, execution, research, communication, and observation stopped fitting cleanly inside one conversational interface.
- Specialized roles for distinct classes of work
- Control plane for policy, routing, and escalation
- Local-first operations with explicit constraints
Context
Who Are They?
The Fleet is a group of AI agents running through OpenClaw on a spare MacBook Air. It is not one large, fuzzy assistant. It is a set of named agents with explicit roles, coordinated through a central control layer. Each agent handles a defined class of tasks, which makes routing more predictable and keeps responsibilities from blurring together.
This is the part of the system that became visible after the earlier planning and telemetry work was already in place. The Fleet depends on the operational logic described in Work Units, Work Units 2, and Field Note 0 - Instrumentation, but it expresses that logic through a more agentic interface. For the path to this architecture, see Transition to OpenClaw.
Introducing the Agents
Blackbird, Mustang, Clipper, Dragon Lady, Nighthawk, Shooting Star, Hawkeye, and Sentry comprise the Fleet. The squadron naming is not decorative. It gives each role a handle that remains usable under load, and it keeps the system from collapsing back into "the chatbot did something."
Foundational Work Behind the Concept
The Fleet did not appear all at once. It grew out of several earlier efforts:
- the original AI-agent experiments described in AI Agents
- the capacity and telemetry logic described in Work Units and Work Units 2
- the observability frame in Field Note 0 - Instrumentation
- the practical migration described in Transition to OpenClaw
That history matters because the Fleet is not just a collection of prompts. It is the current expression of a longer attempt to build systems that are useful under constraint.
Project timeline
Development chronology reconstructed from the system history described here. The Fleet is a living local architecture, not a single public repository with a clean commit boundary.
- Stage 01 · foundations
Carry forward planning and telemetry
The Fleet inherited the earlier work on daily planning, Work Units, and instrumentation instead of treating agents as a fresh layer with no memory of the failures below it.
Result: the architecture started from an observability problem, not from a desire to multiply assistants.
- Stage 02 · roles
Give each class of work an owner
Planning, execution, research, communication, observation, and maintenance were separated into roles with defined inputs, outputs, responsibilities, and constraints.
Result: a task could have an accountable path instead of ending as “the chatbot did something.”
- Stage 03 · control
Add routing and escalation
A control layer was added so requests could be routed, outputs could follow a known format, and policy or escalation had a visible place to live.
Result: coordination became a system concern rather than a conversational habit.
- Stage 04 · locality
Make model choice part of the architecture
Local models, external APIs, and mixed setups were treated as routing decisions shaped by privacy, persistence, task demands, and reliability.
Result: the model became one replaceable component inside a governed workflow.
- Current · operations
Keep the loop inspectable
The operating loop is now task → route → structured result → check or handoff, with the architecture still evolving around legibility and capacity-aware support.
Current state: the Fleet is useful when its boundaries remain visible enough to maintain.
System
Their Assistance and Architecture
The Fleet handles planning, execution, research, and communication workflows. Rather than running everything through one conversational interface, it distributes responsibilities across specialized agents. That is not branding; it is a debugging strategy. If a task goes sideways, the system needs to show which role owned it and what boundary failed.
The point of the architecture is not novelty. The point is legibility. If one agent is responsible for routing, another for execution, and another for observation or communication, then it becomes possible to see where work is happening, where failure occurs, and how responsibilities should evolve over time.
Types of Assistance
The Fleet supports several categories of work:
- Task planning and execution for structured handling of defined tasks and workflows
- Research and knowledge synthesis for gathering, comparing, and summarizing information
- Writing and communication for turning unstructured inputs into usable output
- Workflow automation for scheduled or repetitive processes
- Capacity-aware decision support for comparing work against available limits
- System maintenance for monitoring, logging, and operational upkeep
Each capability is handled by agents designed for a specific domain of work. Agent roles define types of tasks rather than one-off actions, which lets the Fleet work across different contexts without turning into a pile of bespoke prompts.
System Structure and Agent Roles
Rather than sharing responsibilities across a single model, roles are decomposed into independent modules. Each agent owns a class of tasks. The point is boring but important: fewer smeared responsibilities, fewer mystery failures, and a cleaner path for changing one part of the system without rewriting the whole thing.
Each agent follows a consistent design model:
- Purpose: primary responsibility within the system
- Responsibilities: the kinds of tasks handled
- Inputs: what the agent receives
- Outputs: the structured results it produces
- Constraints: the boundaries it should not cross
This structure keeps the Fleet closer to a small operations desk than to a single chat interface with many moods.
Interaction Model and Control Plane
The Fleet works through an explicit control layer rather than direct free-for-all interaction. Eight agents improvising over the same task would create more ambiguity than capability. Requests need routing, outputs need format, and the whole system needs enough order to remain legible without extra cognitive cost.
The control plane matters for three reasons. First, it decides where a task should go. Second, it sets expectations for what kind of answer should come back. Third, it provides a place for policy, coordination, and escalation. In practice, that means the Fleet behaves less like a loose collection of assistants and more like a governed system.
This is also what makes the architecture compatible with local models, external APIs, or mixed setups. The model is important, but the orchestration logic matters just as much. Good routing and clear operational boundaries often improve outcomes more than simply swapping in a larger model.
Design Principles
Several principles govern the Fleet:
- Legibility over spectacle: the system should be understandable to inspect and maintain
- Specialization over vagueness: agents should have real boundaries
- Locality where possible: sensitive or persistent work should stay close to the local infrastructure
- Determinism where it matters: repeatable workflows should not depend on improvisation
- Constraint-awareness: the system should respect capacity rather than maximize output blindly
Those principles are what keep the Fleet from becoming novelty infrastructure. The system has to be useful, but it also has to be understandable: clear enough to inspect, bounded enough to trust, and ordinary enough to maintain.
Operational Model
Operationally, the Fleet is meant to reduce overhead rather than create it. The desired loop is simple:
- A task, need, or question enters the system.
- The system routes it to the right agent or workflow.
- The result comes back in a structured form.
- The output can be used directly, checked, or fed into the next step.
That sounds obvious, but the earlier versions of the system were not simple in that way. They had useful components, but too much depended on brittle automation, manual intervention, or context that lived only in operator memory. The Fleet moves that context into visible operating surfaces without sanding off the nuance that made the earlier versions helpful.
Current state
Why a Fleet?
The short answer is that one general assistant was not enough. A single agent can be convenient, but it tends to smear together planning, execution, memory, and synthesis. That makes failure harder to diagnose and boundaries harder to preserve.
A fleet model provides separation of concerns. One part of the system can stay focused on routing, another on search or synthesis, another on execution, and another on communication. That separation matters technically, but it also matters cognitively. When responsibilities are distinct, the system becomes easier to trust.
Summary and Closure
The Fleet is an operational answer to a problem that started much earlier: how to make AI assistance legible, bounded, capacity-aware, and useful in daily life. The architecture is still evolving, but the core idea is stable. One agent can help. A coordinated fleet can become infrastructure.
Artifacts