The Design Model
The orchestration layer should be explicit:- A deployment starts a workflow or agent when an event, webhook, message, or schedule fires.
- A workflow owns known process states and branches.
- A workflow can call another workflow when a step is reusable across multiple processes.
- A workflow can call an agent when a step needs judgment or natural language work.
- An autonomous agent can call specialized agents when a task should be delegated.
- An internal escalation agent keeps human approvals and questions inside the operational loop.
- A Duckie Assistant agent reviews runs, reports on behavior, and proposes improvements to Duckie objects.
What Each Component Owns
| Component | Owns | Avoid using it for |
|---|---|---|
| Deployment | Trigger source, channel, mode, and schedule | Business logic that belongs in a workflow or agent |
| Workflow | Deterministic process state, branch logic, approvals, retries, and tool order | Open-ended reasoning or broad research |
| Autonomous agent | Judgment, language, investigation, and flexible tool use | Strict compliance branches that must run the same way every time |
| Internal channel agent | Human approvals, escalation questions, reviewer decisions, and structured handoffs | Duckie workspace maintenance or configuration updates |
| Duckie Assistant agent | Run inspection, workspace inspection, reporting, feedback loops, and configuration improvements | Direct customer support or real-time approval routing |
| Callable agent | A focused subtask with a clear contract | General orchestration of the full process |
| Tool | A specific read or write action | Policy decisions or process ownership |
A good design usually uses a workflow backbone with agents at the points where judgment, language, or tool choice matters.
Design From the Business Process
Start by writing the process in normal operational language:- What starts the process?
- What facts are always required?
- Which branches are deterministic?
- Which steps require judgment or language?
- Which humans approve, review, or provide missing context?
- What should be reported daily or weekly?
- How should mistakes become improvements?
Common Patterns
Workflow Backbone With Specialist Agents
Use this when the process has known stages but individual stages need judgment.Internal Channel Agent for Human Review
Use this when the system needs quick human input without moving people out of Slack or another internal channel.Scheduled Reporting Agent
Use this when stakeholders need recurring visibility into operational health.Design Checklist
- Put deterministic routing in workflows.
- Put uncertain interpretation in agents.
- Put repeated subprocesses in callable workflows.
- Put specialized judgment in callable agents.
- Put human approvals and escalations in internal channel agents.
- Put reporting, run review, and behavior improvement in Duckie Assistant agents.
- Put recurring operational review in scheduled deployments.
- Put powerful write actions behind clear scopes and approval gates.
- Track categories, attributes, and outcomes from the start.
Related Docs
Workflows
Build deterministic process logic.
Autonomous Agents
Configure agents that reason and use tools flexibly.
Duckie Assistant Agents
Build agents for reporting, run review, and Duckie configuration improvements.
Scheduled Deployments
Run agents on recurring schedules.