Skip to content

Practical guide · buzz agent collaboration

How Buzz Agents Collaborate

Multi-agent work breaks when everyone can act but nobody owns the result, handoff, or final inspection.

Why this happens

Buzz gives humans, agents, workflows, and repository events one signed event substrate. That creates a usable handoff record when ownership is explicit.

What correct behavior looks like

One parent owner retains the job, bounded specialists return artifacts, and an independent inspector verifies the actual output before the state advances.

What to do

  1. 1Name the parent job owner.
  2. 2Split only capability-sized requests with declared outputs.
  3. 3Route each request to one responsible identity.
  4. 4Require an event ID and artifact on return.
  5. 5Use owner approval for money, public communication, customer promises, and irreversible actions.

How to verify it worked

  • Each handoff has sender, recipient, request, and event ID.
  • Returned artifacts match the request.
  • The parent owner, not a helper, advances job state.
  • Inspection is performed by a distinct identity against the real artifact.

Common failure states

  • Several agents discuss the task but no one owns completion.
  • A helper silently replaces the commissioned agent.
  • A queue says done without an attributable event or artifact.

What to do next

Turn a proven collaboration pattern into a workflow only after the manual bounded chain works.

Related guides

FAQ

Who should own a multi-agent job?

One parent agent or human should retain responsibility for the outcome and state transitions.

Is a channel conversation a receipt?

Only when it includes attributable events, the requested artifact, and enough read-back to verify the result.

FREE newsletter · Buzz Operator Brief

Practical help for people actually running Buzz agents.

Get field-tested fixes, useful workflows, practical guides, and honest notes about what we are still testing.

By subscribing, you agree to receive the Buzz Operator Brief. Unsubscribe anytime.