packages/workflow/README.md

# workflow/ — dynamic-workflow capability family

English | [中文](README.zh.md)

This family runs model-authored orchestration workflows over subagents and exposes general and fixed-policy tools to the model.

| Package | Role | ctx key |
|---|---|---|
| [`workflow/`](workflow/README.md) | Defines workflow execution and lifecycle events | `ctx.workflows` |
| [`workflow-workerthread/`](workflow-workerthread/README.md) | Runs workflow scripts in worker threads | registers on `ctx.workflows` |
| [`tool-workflow/`](tool-workflow/README.md) | Exposes general workflow execution to the model | registers on `ctx.tools` |
| [`tool-ralph/`](tool-ralph/README.md) | Exposes the fixed fresh-agent Ralph workflow | registers on `ctx.tools` |

Worker threads isolate workflow execution from the host event loop but are not a security boundary. See the [dynamic-workflow](../../.agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md) and [Ralph tool](../../.agents/notes/implemented/feature/2026-07-19-fresh-agent-ralph-workflow-tool.md) decisions.

The subsystem reference — start requests, `WorkflowMeta`, results, live runs, `workflow/*` events — is [docs/subsystems/workflow.md](../../docs/subsystems/workflow.md); decisions in the [dynamic-workflows](../../.agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md) and [Ralph consumer](../../.agents/notes/implemented/feature/2026-07-19-fresh-agent-ralph-workflow-tool.md) Agent Notes.
workflow: dynamic workflows — script-driven multi-agent orchestration 2026-07-05 13:29:35 +08:00			`# workflow/ — dynamic-workflow capability family`

docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`This family runs model-authored orchestration workflows over subagents and exposes general and fixed-policy tools to the model.`
workflow: dynamic workflows — script-driven multi-agent orchestration 2026-07-05 13:29:35 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`workflow/`](workflow/README.md) \| Defines workflow execution and lifecycle events \| `ctx.workflows` \|
			\| [`workflow-workerthread/`](workflow-workerthread/README.md) \| Runs workflow scripts in worker threads \| registers on `ctx.workflows` \|
			\| [`tool-workflow/`](tool-workflow/README.md) \| Exposes general workflow execution to the model \| registers on `ctx.tools` \|
			\| [`tool-ralph/`](tool-ralph/README.md) \| Exposes the fixed fresh-agent Ralph workflow \| registers on `ctx.tools` \|
workflow: dynamic workflows — script-driven multi-agent orchestration 2026-07-05 13:29:35 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`Worker threads isolate workflow execution from the host event loop but are not a security boundary. See the [dynamic-workflow](../../.agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md) and [Ralph tool](../../.agents/notes/implemented/feature/2026-07-19-fresh-agent-ralph-workflow-tool.md) decisions.`
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
			The subsystem reference — start requests, `WorkflowMeta`, results, live runs, `workflow/*` events — is [docs/subsystems/workflow.md](../../docs/subsystems/workflow.md); decisions in the [dynamic-workflows](../../.agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md) and [Ralph consumer](../../.agents/notes/implemented/feature/2026-07-19-fresh-agent-ralph-workflow-tool.md) Agent Notes.