Workshops/Collaboration

ADPS Design Pattern Workshop Series

First Collaboration Module Workshop

Task, context, authority, evidence, and responsibility across multi-agent and human collaboration.

25 August 2026

HostsHaili Zhang and Jia Huang
Core workshop guestsDong Zhang and Wei Wang

The session began with LangGraph, Deep Agents, and the six ADPS collaboration patterns, then moved into delegated authority, cross-session conflicts, heterogeneous agents, hook composition, human relationships, and the Agent OS analogy. Several questions changed how the module is organized and exposed an important boundary between C6 Choreography and G5 Hooks Pipeline.

Three collaboration planes: agent-agent, human-agent, and human-human around agent systems
A collaboration design that shows only agent-to-agent arrows misses intent, authority, team decisions, and takeover.

1. Dynamic sub-agents can still be centrally orchestrated

A dynamic workflow may let a model interpret the task, select sub-agents, generate call steps, and pass them to an interpreter. The flow changes at runtime, but the interpreter still owns the current plan, call order, and result aggregation.

An order flow makes choreography concrete. A payment service publishes PaymentConfirmed. Inventory subscribes, reserves stock, and publishes StockReserved. Delivery and notification services subscribe to that new event and act under their own rules. No orchestrator stores the full payment-inventory-delivery-notification plan. By contrast, a model may select sub-agents at runtime while one interpreter still owns the plan, call order, and result aggregation; that remains dynamic orchestration. Runtime change is not the criterion. Ownership of the complete plan is. C6 therefore remains a candidate.

Dynamic orchestration retains one plan owner; choreography advances through participant-local event rules.
Dynamic orchestration retains one plan owner; choreography advances through participant-local event rules.

2. Six design topologies can lower to three runtime primitives

Dong Zhang observed that many runtime graphs reduce to serial, parallel, and routing. That helps implementation, not design semantics. A lead-worker-acceptance hierarchy and a generator-reviewer-adjudicator review may use similar edges while retaining different responsibility and authority.

Many enterprise collaboration graphs eventually reduce to serial edges, parallel branches, and routing. That observation is useful at runtime, but it does not remove the design semantics of loops, hierarchy, or orchestration.

Hierarchical Delegation may execute as route, parallel workers, and gather. Adversarial Review may execute as generate, review, adjudicate, and conditional loop. Similar low-level edges still carry different ownership, acceptance, and failure responsibilities. ADPS calls this topology lowering: preserve responsibility in design, then compile it into runtime primitives supported by the framework.

Topology governance matrix across serial, parallel, routing and identity, authority, safeguards, provenance
The runtime graph shows how control unfolds. Identity, authority, safeguards, and provenance determine whether it is ready for production.

3. Every topology needs four more checks

Dong Zhang applied identity, authority, safeguards, and provenance to each topology. A lead who may read the full batch does not imply that a worker verifying one record inherits that scope. A gather node may read every branch result without gaining authority to mutate source records.

Runtime structureIdentityAuthoritySafeguardsProvenance
SerialPrincipal at each hopScoped per leg and reclaimedGates stop error propagationLinear responsibility chain
ParallelIndependent shard rolesBranch isolation; read-only gatherBranch checks plus global validationOne trace with child spans
RoutingRoute matches identity and riskTighter scope on high-risk routesIngress filtering and differentiated controlsRoute reason and full path

A manager's broad data access should not automatically pass to a worker that verifies one record. Effective authority narrows across user scope, task scope, agent role, tool, and resource. Sharing a long-lived human token across the graph spreads the user's maximum authority to every participant.

4. Production requires a freezing gradient

Development can allow coding agents to split work and try new branches under close review. In test, the main graph, agent roles, tools, and policies become versioned. Staging approaches production conditions. Production pins agent, model, tool, and policy versions while keeping only evaluated dynamic choices.

5. Collaboration has three planes

Wei Wang added a third relationship: project decisions must re-enter shared assets. Agents may hand off correctly and humans may approve, yet product, engineering, and test decisions made in meetings remain invisible to the next agent unless they enter versioned project assets.

Agent-Agent collaboration covers decomposition, parallel work, hand-off, and review. Human-Agent collaboration covers intent, missing evidence, approval, takeover, and acceptance. Human-Human collaboration around the agent carries team decisions and responsibility over time.

The third plane often remains in meetings and chat. A later agent can read the repository but cannot see why a path was chosen. Decisions, evidence, and boundaries that affect future work belong in versioned assets such as RFCs, ADRs, and runbooks. Raw conversations do not need to be copied wholesale.

6. Worktrees do not isolate every conflict

Wei Wang described a conflict that separate Git worktrees did not prevent. Two sessions allocated the same requirement identifier. Shared configuration, test databases, deployment environments, and API contracts create the same class of conflict.

Separate worktrees isolate files, but concurrent sessions may still compete for requirement IDs, shared configuration, test databases, deployment environments, and external quotas. The scheduler must identify the write-conflict domain before launching parallel work.

7. A hand-off needs a contract

Conversation history rarely states which decisions are binding, which paths were rejected, what the next role may change, and how its work will be accepted.

handoff_id: h_01K...
goal: preserve the compatibility interface
from_role: requirements-agent
to_role: implementation-agent
artifacts:
  - uri: artifact://spec/417
    version: sha256:...
decisions:
  - choice: keep the public schema
    evidence: adr://23
authority:
  allowed_tools: [repo_read, patch_write]
  resource_scope: repo://service-a
acceptance:
  checks: [unit_tests, contract_tests]

A Handoff Contract transfers goal, artifacts, decisions, authority, responsibility, and acceptance together. The receiver explicitly accepts or rejects the hand-off, and temporary authority from the previous leg is reclaimed.

8. Independent review creates its own gap

Separating generator and reviewer reduces self-review bias. Execution may then expose missing dependencies, version differences, or insufficient authority. Those facts must return to the review layer; otherwise the next run repeats an obsolete judgement.

9. A hook is a mechanism whose role comes from composition

Wei Wang asked whether hooks form an independent collaboration pattern. Starting coding after requirements, pausing before a dangerous call, tracing after a call, and checkpointing on failure were assigned back to orchestration, governance, observation, and recovery. The hook supplies a deterministic insertion point; its design role comes from the responsibility it carries.

The same hook mechanism can start a coding agent after requirements, pause before a dangerous tool call, record trace data, save a checkpoint, or release resources. These are orchestration, governance, observation, and recovery roles.

No C7 was added. G5 keeps its historical identifier for deterministic governance enforcement. Cross-module use is documented in the Hook Composition topic.

10. Probabilistic core, deterministic shell

ambiguous goal → model interpretation and candidates → structured intent
              → rules / state / authority / tests → controlled action → external result

Models handle open-ended understanding, planning, and candidate generation. Identity, money, resources, state transitions, idempotency, tests, and receipts require reproducible mechanisms. The shell protects boundaries that cannot be carried by probability.

11. Agent OS is an engineering checklist

Dong Zhang began with processes, threads, coroutines, and IPC; Haili Zhang added service-based sub-agents, standard protocols, and virtual file systems. The analogy checks scheduling, isolation, communication, and storage. The workshop did not claim that today’s agent runtimes already constitute an operating system.

The operating-system analogy helps locate missing responsibilities: scheduling, isolation, communication, storage, identity, observability, reclamation, and failure handling. It is not evidence that Agent OS already has a stable industry boundary, and operating-system terms should not be mapped mechanically.

12. Abstract, then reconstruct

Jia Huang tested abstraction with two apparently similar batch jobs. Eight hundred résumés and eight hundred code files can both be sharded in parallel, but one carries candidate privacy and hiring adjudication while the other carries worktrees, tests, and repository merge authority. A pattern that cannot reconstruct those differences has abstracted too far.

Abstraction extracts recurring structure. Reconstruction restores roles, objects, state, authority, evidence, and acceptance to test whether the structure can be built. A difference must survive abstraction when it changes business judgement, state transition, power boundary, evidentiary effect, next action, responsibility, or acceptance.

Resulting revisions

  1. A new Collaboration module overview separates relationship patterns, constraints, distributed candidates, and implementation mechanisms.
  2. C1-C5 now cover task identities, write-conflict domains, review feedback, Handoff Contracts, and cross-session isolation.
  3. C6 distinguishes dynamic orchestration from choreography and remains a candidate.
  4. G5 retains its identifier; cross-module hook composition moves to a topic.
  5. G4 remains a legacy catalog entry that leads to X1 Observability.

Open questions

Related pages

The public record is organized by technical theme. Names, scale, rules, and responsibility structures of internal systems are anonymized.

Chronicle

Recorded source
First Collaboration Module Workshop; workshop held on
Source date
First published on ADPS

View in the ADPS Chronicle