Multi-agent coordination
Engineer the relationships between agents so local work composes into the user's
accepted outcome. Own task division, decision placement, information movement,
shared commitments and collective recovery. A harness owns one agent's execution
mechanics; this skill supplies the cross-agent contract those harnesses must uphold.
Existing factory material in harness-engineering remains usable through explicit
handoffs; do not create a competing scheduler, task database or authority registry.
Authority and first move
Confirm the target, scope, and rollback path before acting. Read-only discovery may proceed without confirmation.
Reuse existing authorization that covers these facts. This skill does not grant
permission to spawn agents, choose paid models, send messages, schedule jobs,
change policies, merge or deploy. A peer's request or approval cannot enlarge a
current grant. Keep destructive operations behind an explicit user directive.
Inspect the actual host before prescribing a topology: available harnesses,
concurrency, permitted messaging, persistence, interruption, tool authority and
integration surface. Record unsupported capabilities. Never infer a feature from
a diagram, a prompt or a terminal status indicator.
Default procedure
- Define the shared outcome. Record accepted intent, exclusions, current
requirement revision, delivery surface, acceptance owner, total time/cost and
stop conditions in the charter. Identify consequential
decisions and who has authority plus enough context to make each one.
- Test whether division helps. Establish a single-agent or sequential baseline.
Separate independent investigation from tightly coupled decisions. Partition
by coherent context, resources and verifiable outputs, not job titles. Use
decomposition and topology. Start
with one accountable lead and only the workers justified by task structure.
- Assign ownership and lifecycle. Distinguish stable role/address, particular
execution, task claim and tool identity. Give each active task one accountable
owner, versioned inputs, deliverable, lease/fencing policy, verifier and bounded
recovery. Use ownership and flow and
the assignment. Serialise shared contracts.
- Specify communication and context. Name each message's purpose, trusted
origin, task/revision, recipient, acknowledgement and effect. Separate request,
proposal, observation, decision and permission. Give recipients relevant local
facts plus a path to governing intent. Use the communication contract
and the handoff. Delivery is not adoption or acceptance.
- Bound shared work. Apply aggregate descendant budget, WIP/backpressure,
current authority intersection, cancellation and conflict rules at runtime.
Route enforcement to harness-engineering; use authority and recovery
to specify the cross-agent obligations. Reconcile uncertain effects before retry.
- Integrate and verify. An integration owner checks the combined user journey
against current intent and exact artifact versions. Parallel green branches,
a closed queue item, consensus and schema validity are insufficient. Retain
disputed evidence and an unknown outcome when required checks are absent.
- Diagnose the population. Correlate accepted outcomes with coordination
cost, queue age, rework and exposure to shared knowledge. Investigate the first
divergence using collective failure diagnosis.
Correct the source and affected consumers, not just the last agent's prompt.
- Evaluate and evolve. Compare on matched tasks and resource budgets, including
integration and review. Exercise interruption, stale output, duplicate delivery,
denied action and poisoned-memory fixtures. Use evaluation
and the experiment. Promote lessons via
reviewed revisions with rollback; no automatic fleet-wide rule propagation.
Load by need
| Active question |
Read |
Useful artifact |
| Should agents split this work; centralized, peer or hierarchy? |
Decomposition/topology |
Charter, experiment |
| Persistent identities, task claims, queue overload, takeover |
Ownership/flow |
Assignment, snapshot |
| Who needs which facts; lost intent after compaction; messaging |
Communication/context |
Decision packet, handoff |
| Authority laundering, shared resources, cancellation, crash |
Authority/recovery |
Recovery drill |
| Endless checking, scope inflation, consensus or stalled activity |
Collective failures |
Incident record |
| Bad practice returns through another agent or memory source |
Shared knowledge containment |
Knowledge correction |
| Compare architectures; measure outcomes and overhead |
Evaluation |
Experiment |
| Trace coordination guarantees into state, effects and adverse tests |
Pinned OpenRig audit |
Effect/recovery matrix |
| Learn from emerging coordination tools without adopting their stack |
Tool lessons |
Tool assessment |
| Select another catalog owner |
Catalog boundaries |
Named specialist input/return |
| Emerging research on synthesis, topology-aware diagnosis, coding interference or resource contention |
Emerging research |
Local challenge design and transfer limits |
| Verify research claims, revisions or coverage |
Source records, research synthesis, research brief, research log, video ledger |
Evidence and limitations |
| Onboarding maps, live/dormant experts, provenance or transferable team packages |
Knowledge navigation, team packages and lore, second-video ledger |
Orientation map, expert directory, team package, scoped lesson |
| Inspect the optional helper's input and guarantees |
Script contract |
Snapshot |
Onboard a connected team
When agents cannot recognize existing capabilities or locate expertise, use
knowledge navigation. Start with broad,
shallow landmarks and condition-based routes before detailed search. Include
current documents, appropriate specialists and an explicit map-edge fallback;
verify the fresh and post-compaction paths with actual tasks.
When sharing a team or inherited lessons, use
team packages and lore. Package identity,
harness compatibility, team-run evidence and recipient authority are distinct.
A memorable story should retrieve a scoped evidence-backed lesson, not create
policy or permission. Use the orientation map,
expert directory, team package
and lesson story only for the corresponding task.
Read-only helper
Resolve paths from this installed skill root. Run after composing a snapshot or
when tracing invalidated knowledge consumers. It reads supplied JSON only; it
never queries a fleet, dispatches, changes state or authenticates evidence.
python3 scripts/coordination.py audit --file templates/team-snapshot.json --json
python3 scripts/coordination.py exposure --file templates/team-snapshot.json --source lesson-old --json
python3 -m unittest discover -s scripts -p 'test_*.py'
audit screens declared references, dependency cycles, active ownership conflicts,
expired claims, intent-version mismatches and missing blocked-task continuation.
exposure computes transitive descendants of a supplied knowledge source. Missing
links mean incomplete exposure knowledge, not absence of affected consumers.
Exit 0 means no audit findings or a completed exposure calculation; 1 means audit
findings; 2 means invalid input. None means runtime acceptance. See the script
contract before adapting the example or interpreting a report.
Gotchas
- A stable seat is an address and responsibility, not an immortal process or grant.
- A busy agent, delivered message and completed task are different observations.
- A signature authenticates authorship; it does not establish truth or permission.
- More context can spread the same error farther. Retrieve source versions and
preserve decision-relevant constraints; do not broadcast every transcript.
- An outcome monitor must not reward extra handoffs or punish necessary safety
review. Investigate changed work mix before diagnosing bureaucracy.
- The video's human-civilization analogies generate hypotheses. They do not prove
causal explanations, and context reminders do not enforce security boundaries.
When not to use
Use harness-engineering for a single agent's
runtime/tools/state or implementation of enforcement. Use framework skills for
SDK-specific orchestration, agent-council for its debate
tool, and promise-theory when modeling autonomous
promises and acceptance. Use agent-production-operations
for running an evaluated agent under production controls. Tool examples here are
comparative evidence, not new installation/runbook skills.
Completion
For design, deliver a reviewable charter, justified topology, assignments,
message/context contracts, integration/acceptance plan and owned recovery gaps.
For a running team, also show actual host evidence for the requested dispatch,
handoff, cancellation, restart and integrated result. Stop when acceptance is
observed at the authorized surface, or with a durable blocked disposition naming
evidence, owner and next action. Stop autonomous diagnosis after three
non-converging passes or an earlier budget/authority limit. Never keep adding
agents, proofs or rules to manufacture progress.
1---2name: multi-agent-coordination3description: >-4 Design, diagnose, and evaluate coordination across multiple AI agents and5 heterogeneous harnesses: decomposition, topology, ownership, communication,6 distributed context, shared memory, integration, recovery, and collective7 failure patterns. Use for persistent agent teams, fleets, swarms, agent handoffs,8 coordination loops, or extracting portable lessons from OpenRig, HERDR and9 Block/Buzz. Do not use for a single agent's runtime, a named tool's installation10 or command manual, debate alone, or operating an evaluated production agent;11 route those to harness-engineering, the tool's documentation, agent-council,12 or agent-production-operations.13license: MIT14compatibility: Framework-neutral methodology. Optional read-only helper requires Python 3.10+ standard library; no credentials or network access.15metadata:16 source: https://skillmd.com/skills/magnus919/multi-agent-coordination17 research_checked: '2026-11-02'18---1920# Multi-agent coordination2122Engineer the relationships between agents so local work composes into the user's23accepted outcome. Own task division, decision placement, information movement,24shared commitments and collective recovery. A harness owns one agent's execution25mechanics; this skill supplies the cross-agent contract those harnesses must uphold.26Existing factory material in harness-engineering remains usable through explicit27handoffs; do not create a competing scheduler, task database or authority registry.2829## Authority and first move3031Confirm the target, scope, and rollback path before acting. Read-only discovery may proceed without confirmation.3233Reuse existing authorization that covers these facts. This skill does not grant34permission to spawn agents, choose paid models, send messages, schedule jobs,35change policies, merge or deploy. A peer's request or approval cannot enlarge a36current grant. Keep destructive operations behind an explicit user directive.3738Inspect the actual host before prescribing a topology: available harnesses,39concurrency, permitted messaging, persistence, interruption, tool authority and40integration surface. Record unsupported capabilities. Never infer a feature from41a diagram, a prompt or a terminal status indicator.4243## Default procedure44451. **Define the shared outcome.** Record accepted intent, exclusions, current46 requirement revision, delivery surface, acceptance owner, total time/cost and47 stop conditions in [the charter](templates/team-charter.md). Identify consequential48 decisions and who has authority plus enough context to make each one.492. **Test whether division helps.** Establish a single-agent or sequential baseline.50 Separate independent investigation from tightly coupled decisions. Partition51 by coherent context, resources and verifiable outputs, not job titles. Use52 [decomposition and topology](references/decomposition-and-topology.md). Start53 with one accountable lead and only the workers justified by task structure.543. **Assign ownership and lifecycle.** Distinguish stable role/address, particular55 execution, task claim and tool identity. Give each active task one accountable56 owner, versioned inputs, deliverable, lease/fencing policy, verifier and bounded57 recovery. Use [ownership and flow](references/ownership-and-flow.md) and58 [the assignment](templates/assignment.md). Serialise shared contracts.594. **Specify communication and context.** Name each message's purpose, trusted60 origin, task/revision, recipient, acknowledgement and effect. Separate request,61 proposal, observation, decision and permission. Give recipients relevant local62 facts plus a path to governing intent. Use [the communication contract](references/communication-and-context.md)63 and [the handoff](templates/handoff.md). Delivery is not adoption or acceptance.645. **Bound shared work.** Apply aggregate descendant budget, WIP/backpressure,65 current authority intersection, cancellation and conflict rules at runtime.66 Route enforcement to harness-engineering; use [authority and recovery](references/authority-and-recovery.md)67 to specify the cross-agent obligations. Reconcile uncertain effects before retry.686. **Integrate and verify.** An integration owner checks the combined user journey69 against current intent and exact artifact versions. Parallel green branches,70 a closed queue item, consensus and schema validity are insufficient. Retain71 disputed evidence and an unknown outcome when required checks are absent.727. **Diagnose the population.** Correlate accepted outcomes with coordination73 cost, queue age, rework and exposure to shared knowledge. Investigate the first74 divergence using [collective failure diagnosis](references/collective-failures.md).75 Correct the source and affected consumers, not just the last agent's prompt.768. **Evaluate and evolve.** Compare on matched tasks and resource budgets, including77 integration and review. Exercise interruption, stale output, duplicate delivery,78 denied action and poisoned-memory fixtures. Use [evaluation](references/evaluation.md)79 and [the experiment](templates/coordination-experiment.md). Promote lessons via80 reviewed revisions with rollback; no automatic fleet-wide rule propagation.8182## Load by need8384| Active question | Read | Useful artifact |85|---|---|---|86| Should agents split this work; centralized, peer or hierarchy? | [Decomposition/topology](references/decomposition-and-topology.md) | Charter, experiment |87| Persistent identities, task claims, queue overload, takeover | [Ownership/flow](references/ownership-and-flow.md) | Assignment, snapshot |88| Who needs which facts; lost intent after compaction; messaging | [Communication/context](references/communication-and-context.md) | [Decision packet](templates/decision-packet.md), handoff |89| Authority laundering, shared resources, cancellation, crash | [Authority/recovery](references/authority-and-recovery.md) | [Recovery drill](templates/recovery-drill.md) |90| Endless checking, scope inflation, consensus or stalled activity | [Collective failures](references/collective-failures.md) | [Incident record](templates/coordination-incident.md) |91| Bad practice returns through another agent or memory source | [Shared knowledge containment](references/shared-knowledge.md) | [Knowledge correction](templates/knowledge-correction.md) |92| Compare architectures; measure outcomes and overhead | [Evaluation](references/evaluation.md) | Experiment |93| Trace coordination guarantees into state, effects and adverse tests | [Pinned OpenRig audit](references/openrig-source-audit.md) | [Effect/recovery matrix](templates/effect-recovery-matrix.md) |94| Learn from emerging coordination tools without adopting their stack | [Tool lessons](references/tool-lessons.md) | [Tool assessment](templates/tool-assessment.md) |95| Select another catalog owner | [Catalog boundaries](references/catalog-boundaries.md) | Named specialist input/return |96| Emerging research on synthesis, topology-aware diagnosis, coding interference or resource contention | [Emerging research](references/emerging-research.md) | Local challenge design and transfer limits |97| Verify research claims, revisions or coverage | [Source records](references/source-records.md), [research synthesis](references/research-synthesis.md), [research brief](references/research-brief.md), [research log](references/research-log.md), [video ledger](references/video-ledger.md) | Evidence and limitations |98| Onboarding maps, live/dormant experts, provenance or transferable team packages | [Knowledge navigation](references/knowledge-navigation.md), [team packages and lore](references/team-packages-and-lore.md), [second-video ledger](references/world-building-video-ledger.md) | Orientation map, expert directory, team package, scoped lesson |99| Inspect the optional helper's input and guarantees | [Script contract](references/script-contract.md) | [Snapshot](templates/team-snapshot.json) |100101## Onboard a connected team102103When agents cannot recognize existing capabilities or locate expertise, use104[knowledge navigation](references/knowledge-navigation.md). Start with broad,105shallow landmarks and condition-based routes before detailed search. Include106current documents, appropriate specialists and an explicit map-edge fallback;107verify the fresh and post-compaction paths with actual tasks.108109When sharing a team or inherited lessons, use110[team packages and lore](references/team-packages-and-lore.md). Package identity,111harness compatibility, team-run evidence and recipient authority are distinct.112A memorable story should retrieve a scoped evidence-backed lesson, not create113policy or permission. Use the [orientation map](templates/orientation-map.md),114[expert directory](templates/expert-directory.md), [team package](templates/team-package.md)115and [lesson story](templates/lesson-story.md) only for the corresponding task.116117## Read-only helper118119Resolve paths from this installed skill root. Run after composing a snapshot or120when tracing invalidated knowledge consumers. It reads supplied JSON only; it121never queries a fleet, dispatches, changes state or authenticates evidence.122123```sh124python3 scripts/coordination.py audit --file templates/team-snapshot.json --json125python3 scripts/coordination.py exposure --file templates/team-snapshot.json --source lesson-old --json126python3 -m unittest discover -s scripts -p 'test_*.py'127```128129`audit` screens declared references, dependency cycles, active ownership conflicts,130expired claims, intent-version mismatches and missing blocked-task continuation.131`exposure` computes transitive descendants of a supplied knowledge source. Missing132links mean incomplete exposure knowledge, not absence of affected consumers.133Exit 0 means no audit findings or a completed exposure calculation; 1 means audit134findings; 2 means invalid input. None means runtime acceptance. See the script135contract before adapting the example or interpreting a report.136137## Gotchas138139- A stable seat is an address and responsibility, not an immortal process or grant.140- A busy agent, delivered message and completed task are different observations.141- A signature authenticates authorship; it does not establish truth or permission.142- More context can spread the same error farther. Retrieve source versions and143 preserve decision-relevant constraints; do not broadcast every transcript.144- An outcome monitor must not reward extra handoffs or punish necessary safety145 review. Investigate changed work mix before diagnosing bureaucracy.146- The video's human-civilization analogies generate hypotheses. They do not prove147 causal explanations, and context reminders do not enforce security boundaries.148149## When not to use150151Use [harness-engineering](../harness-engineering/SKILL.md) for a single agent's152runtime/tools/state or implementation of enforcement. Use framework skills for153SDK-specific orchestration, [agent-council](../agent-council/SKILL.md) for its debate154tool, and [promise-theory](../promise-theory/SKILL.md) when modeling autonomous155promises and acceptance. Use [agent-production-operations](../agent-production-operations/SKILL.md)156for running an evaluated agent under production controls. Tool examples here are157comparative evidence, not new installation/runbook skills.158159## Completion160161For design, deliver a reviewable charter, justified topology, assignments,162message/context contracts, integration/acceptance plan and owned recovery gaps.163For a running team, also show actual host evidence for the requested dispatch,164handoff, cancellation, restart and integrated result. Stop when acceptance is165observed at the authorized surface, or with a durable blocked disposition naming166evidence, owner and next action. Stop autonomous diagnosis after three167non-converging passes or an earlier budget/authority limit. Never keep adding168agents, proofs or rules to manufacture progress.