End-to-End Flow

Three agents. One binding decision.

Follow a single coordination session from the moment agents introduce themselves, through a bounded session, to a replayable outcome. No code — just the story of how MACP turns a messy multi-agent conversation into one authoritative result.

1The Players

Three agents walk into a session

An architect, a security reviewer, and a cost optimizer need to agree on a Q3 deployment strategy. Each has its own expertise — and its own opinions. Left alone, they'd negotiate forever or reach conflicting conclusions.

Architect
Proposes the deployment strategy
backed by an LLM
Security Reviewer
Evaluates the risk
backed by an LLM
Cost Optimizer
Weighs the tradeoffs
backed by an LLM
2Introductions

Every agent publishes a manifest

Before coordination can happen, agents need to know who else is in the room. Each publishes a manifest — a small card answering: who am I, what can I do, what coordination modes do I support.

architect-agent
Supported Modes
decision.v1proposal.v1
speaks application/json
security-agent
Supported Modes
decision.v1quorum.v1
speaks application/json
cost-agent
Supported Modes
decision.v1task.v1
speaks application/json

With manifests published, our three agents now know about each other and the modes they can speak.

3Open the Session

A bounded context, locked at the start

The architect kicks off a Session: a bounded context where this coordination lives. Three things are immutably bound at the moment the session opens — and cannot change for its lifetime.

Coordination Session
Architect
Security
Cost
Locked for the session's lifetime
Modedecision.v1
Config1.0.0
Policymajority

If these versions could drift mid-session, replay would be meaningless. So MACP freezes them at the door.

4The Dance

Propose · Evaluate · Vote · Commit

Inside the session, coordination unfolds as a structured four-step flow. Each agent contributes at the right stage, with the runtime enforcing who can do what.

Step 1
Propose
by Architect

Suggests blue-green deploy.

Step 2
Evaluate
by Security

APPROVE, high confidence.

Step 3
Vote
by Cost

Votes APPROVE.

Step 4
Commit
by Architect

Binds the outcome.

Only the final Commit makes it binding. Everything before is deliberation.

5Guardrails

Every message earns its place

Agents don't get to write directly into the session log. Each message passes through a chain of checks — any failure, and it's rejected with a precise reason. Pass them all, and it's appended to the authoritative log.

Message
Authenticate

Who are you?

Validate

Is the message well-formed?

Dedupe

Have we seen this already?

Authorize

Can this sender do this?

Append

Into the session log.

Accepted
Passes all gates

The message is appended to the session's append-only log and broadcast to every subscriber in the order the runtime accepted it.

Fails a gate

Rejected with a structured error code (unauthenticated, rate limited, wrong sender, session closed). The log stays clean.

6The Outcome

One binding decision

When the architect commits, the runtime evaluates the majority policy against the accepted history. The commitment is allowed, the session transitions to RESOLVED, and the outcome becomes authoritative.

Decision Committed
Blue-green deploy approved
bindingauditablereplayable
7Forever Replayable

Rewind the whole thing, bit for bit

The session log is append-only and deterministic. Months later, you can replay the exact same sequence — instantly, at 10× speed, or step by step — and always get the same outcome. Crash recovery is just replay with a different trigger.

Open
Propose
Evaluate
Vote
Commit
Replay any time — same inputs, same outputs, guaranteed.
Instant

All events emitted at once — great for fast re-derivation.

Timed

Proportional inter-event timing, perfect for post-mortems.

Step

One event at a time — a debugger for coordination.

That's the whole loop.

Three agents. One session. One binding outcome — structured, auditable, replayable. Every step verified. Every state transition recorded. That's MACP turning multi-agent chatter into coordination you can trust.