README.md 2.4 KB
description: "The workflow group map: model-authored orchestration scripts that fan out subagents, for users and maintainers navigating the group."
kind: "package-group"
packages/workflow
English | 中文
Summary
The workflow group lets an agent run orchestration scripts that delegate work to subagents and return a final value. The workflow tool supports scripted fan-out; the opt-in ralph tool runs a fixed sequence of fresh agents. Scripts use the shared PTC Node process runtime under the calling Session's file policy. Workflow hooks and child lifecycle remain owned by the workflow engine.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
workflow |
Runs a model-written orchestration script that fans out subagents | ctx.workflowEngine |
workflow-ptc |
Runs workflow scripts through the shared sandboxed PTC Node process runtime | registers on ctx.workflowEngine |
tool-workflow |
Gives the model the workflow tool for scripted multi-agent orchestration |
registers on ctx.tools |
tool-ralph |
Gives the model the ralph tool for fresh-agent iterative loops |
registers on ctx.tools |
Related documentation
- Workflow subsystem — the seam's types, start request, and
workflow/*events. - Generated tool catalog — the
workflowtool schema the model receives. - Generated tool catalog — the
ralphtool schema the model receives. - Generated configuration catalog — every accepted engine config field.
- Dynamic workflows Agent Note — the seam design and its decisions.
- Harness-level goal-based execution Agent Note — the fixed fresh-agent loop design and deferred work.