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
| Hosts | Haili Zhang and Jia Huang |
| Core workshop guests | Dong 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.
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.
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.
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 structure | Identity | Authority | Safeguards | Provenance |
|---|---|---|---|---|
| Serial | Principal at each hop | Scoped per leg and reclaimed | Gates stop error propagation | Linear responsibility chain |
| Parallel | Independent shard roles | Branch isolation; read-only gather | Branch checks plus global validation | One trace with child spans |
| Routing | Route matches identity and risk | Tighter scope on high-risk routes | Ingress filtering and differentiated controls | Route 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
- A new Collaboration module overview separates relationship patterns, constraints, distributed candidates, and implementation mechanisms.
- C1-C5 now cover task identities, write-conflict domains, review feedback, Handoff Contracts, and cross-session isolation.
- C6 distinguishes dynamic orchestration from choreography and remains a candidate.
- G5 retains its identifier; cross-module hook composition moves to a topic.
- G4 remains a legacy catalog entry that leads to X1 Observability.
Open questions
- How should design intent survive topology lowering into a runtime graph?
- Which Handoff Contract fields can remain stable across frameworks?
- How can a scheduler discover cross-session write-conflict domains before execution?
- How should hook composition expose order, idempotency, and failure semantics?
- Where does the Agent OS analogy predict useful architecture, and where does it distort it?
Related pages
- Collaboration module overview
- Human-Agent collaboration boundaries
- Hook Composition
- Abstraction and Reconstruction
- Agent OS engineering checklist
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