Workshops/Action
ADPS Agent Design Pattern Workshop Series
ADPS Design Pattern Workshop Series · First Action Module Workshop
Plan and ReAct, structured plans, tool admission, GUI action, sandboxes, and event-driven execution.
| Host | Bingsheng Ru |
| Core participants | Qingfeng Li, Dong Zhang, Jun Luo, Hongshan Tang, Wei Wang, Pylon Peng, Leida Ren |
ADPS held its first workshop on the Action module on 6 August 2026. The group examined how an agent turns a judgment into an operation that an external system can accept, inspect, and recover. The discussion drew on code development, security scanning, GUI automation, R&D platforms, multimodal evaluation, and multi-agent collaboration.
The session ended with two open questions: where Event-Driven belongs in the framework and how much of a Plan DSL can remain stable across domains. Both affect A1–A5 and the candidate status of C6 Choreography.
1. Route between Plan and ReAct by task risk
Code generation, review, testing, and repair can form a loop. Such a loop depends on explicit acceptance conditions: whether tests pass, whether the repair addresses the original failure, and whether the change reaches human review. Model capability affects the speed of the loop; acceptance conditions determine where it stops.
A plan for complex work acts as a recoverable navigation map. Each step needs state, an artifact, and a checkpoint so that an interrupted task can resume from confirmed progress. Small, low-risk work can run directly through ReAct. Long-running work, production environments, and irreversible operations require an explicit plan.
Offline creative environments and online production require different controls. The former can allow experimentation and wider model freedom. The latter needs a fixed pipeline, structured inputs and outputs, and controlled release intervals. Production data can drive offline revisions, which return only after testing and review.
Plan granularity is selected from task length, action consequence, recovery requirements, and the environment's tolerance for error.
2. A structured plan is a compilable execution contract
Bingsheng Ru proposed compiling the Plan itself. Before any tool call, check legality, dependencies, constraints, repeated steps, and uneconomic order. Wei Wang and Pylon Peng then added authority, concurrency conflicts, and cross-project scheduling to the compilation checks.
Plans can be expressed as structured data or a domain DSL, then checked for legality, dependencies, constraints, and cost before execution. An executable plan needs at least a step identifier, dependencies, expected artifacts, acceptance conditions, allowed tools, and a recovery position. Once these fields exist, the system can detect parallel work, repeated reads, and uneconomical ordering.
Domain DSL practice showed why one language rarely transfers unchanged across static analysis, supply-chain scanning, and other tool families. The white paper therefore puts the stable core in a PlanStep contract while domain verbs, parameters, and validators remain in adapters.
3. Action interfaces need an explicit order of preference
A production path can combine fixed routes, dynamic GUI reasoning, and edge-cloud execution. Short tasks use verified static routes. Complex tasks retain dynamic recognition and orchestration. Edge processing performs coarse interpretation and compaction before cloud calls. When a structured interface exists, a Skill or API provides stable parameters and receipts; GUI execution covers capabilities that have not exposed such an interface.
One class of evaluation platform organizes capability as a main agent, role-specific sub-agents, Skills, and CLIs. Skills load on demand, and a sub-agent sees only the tools required for its role. Coding and testing use separate execution and review roles so that one path does not both generate and approve its own work.
These practices give A1 and A5 a common rule: prefer structured interfaces, disclose capability by responsibility, and admit GUI execution only with explicit authorization and acceptance evidence.
4. Tool execution needs sandboxes and release gates
Online pipelines remain within tested formats, tools, and confidence bounds. A model may participate in classification and initial handling, while deterministic flow owns release. Offline revisions use production evidence without allowing a runtime agent to rewrite its production contract.
One class of R&D platform decides after intent recognition whether a task needs a sandbox. Commands and local tools run in a dynamically created sandbox with role, Skill, prompt, and agent configuration. Reasoning and scheduling remain in the main process. This boundary makes command side effects observable and disposable.
The discussion directly supports A4 Guardrail Sandwich: validate permissions, parameters, and environment before execution; run the tool inside an isolation boundary; verify artifacts and side effects afterward.
5. Production workflows compose several topologies
Pylon Peng described a morning workflow that dispatched six sub-agents. They scanned several task sources in parallel, a main agent gathered results and routed work by repository, and design, coding, quality checks, and repair used different loops. The flow spans several cells because each stage carries a different control relationship.
One R&D support system combines routing, multi-source retrieval, sub-agents, sandboxes, and iterative validation. Short tasks can run directly, while work that needs clarification or more context begins with a plan. Index and knowledge services provide candidates, a routing layer chooses an access path, and commands enter a sandbox.
A separate cross-project development flow has sub-agents scan task sources in parallel, a main agent aggregate and orchestrate, and routing send work to the relevant repository. Design and quality checks converge through loops. People intervene mainly at design confirmation and final acceptance.
Both cases show that a topology describes a local control structure. One production workflow may use parallelism, routing, orchestration, loops, and hierarchy at different stages without assigning a single topology label to the whole system.
6. Event-driven defines triggering and delivery; choreography defines collaboration
Pylon Peng asked whether Event-Driven should become a topology; Leida Ren added an event-reactive multi-agent practice. Their examples separate trigger and delivery from control structure: events determine when work appears and how it is delivered; topology determines who owns the plan and how work branches and closes after it appears.
The workshop asked whether Event-Driven should become a seventh execution topology and reached a useful distinction: a loop uses a termination condition to decide whether to continue, while an event uses a trigger condition to decide when to start. A queue also adds persistence; an event can wait while a downstream agent is unavailable. Existing multi-agent practice includes one agent emitting an event that other agents consume.
The challenge to a seventh-topology classification is that an event explains how work starts and travels. Once started, the work still takes the form of a chain, route, parallel branch, orchestration, loop, or hierarchy. Event listening may also be part of perception.
ADPS currently separates the concepts as follows:
- Event-driven execution defines triggers, delivery, waiting, and replay.
- Execution topology defines how control unfolds after work begins.
- Choreography defines collaboration among agents that react through local rules and events without a central orchestrator.
The workshop recorded an existing multi-agent practice that uses events for collaboration. C6 Choreography remains a candidate, and Event-Driven does not become a seventh core topology column in this release.
7. Concepts extracted from the workshop
| Concept | Workshop definition | Current status |
|---|---|---|
| PlanStep contract | Describe one executable unit through identity, dependencies, artifact, acceptance, eligible tools, and recovery position | Added to A2 |
| Action interface priority | Prefer domain APIs and Skills, then controlled CLI; use GUI as an authorized compatibility path with evidence | Selection rule in the action overview |
| Tool admission | After selection and before execution, check authority, risk, state freshness, and parameter provenance | Interface between A1 and A4 |
| Event-topology separation | Events describe triggering and delivery; topology describes control after the task begins | Module-level classification rule |
| Action evidence chain | Use ActionEvent, business ledger, external receipt, and checkpoint to establish action and outcome | Cross-cutting action and governance requirement |
These concepts explain how A1–A5 cooperate in one runtime. They do not create another action-pattern number.
8. Changes made to the white paper
- A1 Tool Dispatch now emphasizes capability registration, candidate reduction, interface preference, and admission criteria for GUI fallback.
- A2 Plan-and-Execute treats a plan as a versioned structured contract whose steps carry dependencies, artifacts, acceptance conditions, and recovery positions.
- A3 Prompt Chaining passes structured artifacts between steps and releases each artifact only after its stage check succeeds.
- A4 Guardrail Sandwich defines pre-execution validation, isolated execution, and post-execution verification, with command tools directed to sandboxes.
- A5 Minimal Tool Set uses responsibility boundaries and progressive disclosure to control the tool surface.
- C6 Choreography remains a candidate extension pending independent evidence across more cognitive functions and documented failure cases.
9. Open questions
- Which Plan DSL fields can remain stable across domains, and which belong in domain adapters?
- What measurable threshold should move a task from direct ReAct to an explicit plan?
- What authorization, UI evidence, and failure receipt should a GUI fallback produce?
- How should a sandbox connect commands, file changes, network access, and resource use to one Action trace?
- What interfaces should connect event-driven mechanisms to perception, governance, and choreography?
Related pages
- A1 Tool Dispatch
- A2 Plan-and-Execute
- A3 Prompt Chaining
- A4 Guardrail Sandwich
- A5 Minimal Tool Set
- C6 Choreography
- White Paper contributors
This page lists workshop participants and consolidates the discussion by theme. It does not map internal practice point by point to a person or organization. Conclusions adopted after comparison appear in the Action module overview and individual pattern specifications.
Chronicle
- Recorded source
- ADPS Design Pattern Workshop Series · First Action Module Workshop; workshop held on
- Source date
- First published on ADPS