An operating manual / Nate Hamilton

AI Agent Operations: Orchestration, Buses, Gates & Receipts

How an AI-agent company works: how agents coordinate, stay running, pass required checks, and prove their work.

I hand work over through a shared message log called the bus. Scheduled wake-ups, or heartbeats, let agents check on it. Independent checks called gates decide what can move forward. The receipt has to come from the live result. For the operating model and the human’s role, start with How to Run a Company with AI Agents.

For the code boundaries under these operations, use The 16 Architectural Boundaries for AI Systems: the technical reference on runtime isolation, typed contracts, tools, and shared processing.

Last updated

01 / Operations

How do AI agents coordinate work?

AI agents coordinate through a shared message bus: a log that keeps messages stored. Every message is a line written to that log, synced across machines; agents post work and handoffs there. Durability means the message stays safe. Delivery means someone saw it. Those can fail independently.

Before the handoff, I use decompose-before-dispatch: at most six yes-or-no checklist items per assignment, with separate sets of files for agents working at the same time. The checklist stays available for verification after the agent returns.

A handoff needs to say what work is waiting, whose judgment is needed, and what evidence to inspect. Putting it on the shared bus lets agents coordinate without routing every request through me. The log keeps the request available after the moment it was sent.

The notifier alerts the recipient. It does not keep the messages stored. If the notifier stops, the recipient still needs a way to read the log directly and pick up the waiting work. The recovery flow below shows that path.

The shared messaging system went dark for 72 minutes. We lost nothing, but the requests waiting on me looked ignored. records what happened when the notifier failed. The messages stayed stored, and reading the inbox directly recovered the backlog without asking anyone to resend it.

02 / Operations

How do you keep AI agents running without a human in the loop?

A scheduler wakes agents at regular intervals to check messages and advance work within their written job limits. These scheduled wake-ups are heartbeats. At each wake-up, the agent checks whether anything needs doing. It can leave things as they are. The human still sets direction and handles decisions outside the agent’s authority.

Each time the loop runs, it needs a decision: check the inbox, check the current evidence, and decide whether to act, wait, or ask for a decision. Write down what fresh evidence makes a job worth repeating. Another tick of the clock does not establish that the business needs another change.

The smartest thing my night-shift agent did all month was refuse to publish shows why that matters. An agent declined another near-identical post and improved existing work instead. Other refusals were logged with reasons, including missing signal that turned out to come from stale input data.

03 / Operations

What is a gate in an AI-agent system?

A gate is a required check that blocks progress until it passes. The built-right gate asks whether the work is engineered correctly; the will-it-earn gate asks whether it serves a real customer and can earn. An is-it-worth-building gate asks the customer question before code. Independent owners hold the engineering and commercial judgments, and done requires every required gate to pass, with evidence.

Before code: is it worth building?
Identify a real customer and a painful, paid-for job before starting the build. The product owner can stop the bet here. Building ability does not establish demand.
Built right: does the work hold up?
Require evidence that the result is production-ready and tested. Give the engineering owner authority to block progress when the work or its evidence fails.
Will it earn: does the business case hold up?
Require a real customer, a live way to pay, and working unit economics. The commercial owner has a separate veto; an engineering pass cannot override it.

We gave two different agents the power to block a release — on purpose. records the rule I use: neither owner can call the product done alone. Both must pass, and the product must be in-market and earning. Checking whether it is worth building first saves us from discovering the missing customer after the code is written.

04 / Operations

How do you prove an agent's work is actually done?

An agent proves work is done with a receipt from the live thing: a URL that loads, a check against the live system that passes, or real output that demonstrates the required outcome. Merged code, a completed build, and passing tests do not establish that outcome on their own. The receipt must meet the agreed conditions for accepting the work, and the required independent review must pass before the work closes.

Match the receipt to the claim. A loaded URL proves the page is reachable; it does not prove a save works. For that, save, reload, and inspect the saved state. A success message proves only that a message appeared.

A green checkmark that isn't the AI's own word: building a quality check with teeth records why the checker needs scrutiny too. It produced false failures and exposed checks that worked in isolation without running in the live workflow. Keep unchecked work visibly unchecked, reject an all-waived result, and require evidence before a finding can be marked addressed.

I don't let my own AI say a high-stakes release is done. A rival AI signs off first gives the production-ready verdict to a different model family from the builder. A failed review held the release, but the reviewer also made false claims. Reproduce disputed findings. I need evidence strong enough to overrule either agent.

For instructions you can hand to an agent, use the delegation playbook’s acceptance receipt, alongside its charter, stop-list, and handoff templates.

Source note: these AI Guide examples are my published operating accounts. The underlying evidence records do not currently have public artifact links. The notes explain what was checked; they are not a substitute for inspecting your own live result.

05 / Operations

What happens when the system fails?

When the notifier fails but the durable log survives, messages remain stored while delivery waits. Recover by reading the log directly and inspecting the unread work. Design notification so losing it only delays delivery, and make automatic requests for a decision distinguish ‘no one has seen this’ from ‘someone saw it and passed.’ Silence alone does not tell you which happened.

In The shared messaging system went dark for 72 minutes. We lost nothing, but the requests waiting on me looked ignored., waiting approvals looked ignored because the notifier had stopped. An escalation timer treated the silence as stalled work. The backlog was intact; the messages were still there, waiting for attention.

  1. Check storage and attention separately. Verify that the message exists in the log, then establish whether the intended recipient has seen it. One answer cannot stand in for the other.
  2. Keep direct reading available. Agents or a human need a recovery path that bypasses the notifier. The standing habit from the failure was to inspect the log directly instead of trusting alerts alone.
  3. Make escalation describe what is known. An unseen request and a considered pass need different responses. Design that distinction into the escalation before a timer turns delayed delivery into apparent neglect.

This is how I want failure contained: the notification can stop without taking the work record with it. The recovery still needs attention, but it does not need the sender to reconstruct the request.

06 / Quick answers

Frequently asked questions

What is the difference between a message bus and a queue?

A bus connects participants through messages; a queue holds work for consumption. Either can be durable. In this model, the shared bus is a durable log that can be read directly, and notification is separate. The useful question is whether a message survives when its notifier stops.

How many AI agents do you need?

There is no required headcount in this model. Define the work and its owners first. Keep the built-right and will-it-earn judgments with independent owners, and give each agent a bounded charter before adding more coordination.

What is an agent heartbeat?

A heartbeat is a scheduled wake-up to inspect messages, check the current state, and decide whether work needs advancing. It is permission to inspect, not a requirement to create output. A logged reason to take no action can be the right result.

Does passing the build mean an agent is done?

No. A passing build proves the build passed. Done requires evidence from the live outcome and the required independent gates. For a product, my operating rule also requires it to be in-market and earning.

Can agents recover messages after a notifier fails?

In this model, yes: messages persist in the shared log independently of the notifier. Reading the log directly recovers the unread backlog. That recovery path depends on the durable store remaining intact; a working notification is not proof that storage is safe.

Browse AI Guides