Usage
~workflow-create-run/workflow
When to use
when a task needs a multi-step workflow but no existing workflow matches when the manager agent needs to create and run a workflow in a single delegation when the user describes a goal that would benefit from a custom pipeline but wants results, not a workflow artifact
When not to use
when an existing workflow already handles the task (use it directly) when the user wants to keep the workflow as a reusable artifact (use workflow-creation-iterative instead) when the task is simple enough for a single agent without orchestration
Configuration
workflow-creator |
Pipeline
workflow-creatorworkflow-create-run-temporaryworkflow=
Createworkflow-creatorworkflow_set_contextExecute
context-writable=trueworkflow_set_contextExecuteCleanup
Createpersist="full"workflow-creatormax-session-turns
create-prompt
create-promptThe workflow MUST be created with the exact name "workflow-create-run-temporary" as an ephemeral workflow in the workspace. This means: Directory: .stencila/workflows/workflow-create-run-temporary/ File: .stencila/workflows/workflow-create-run-temporary/WORKFLOW.md A .gitignore file containing exactly "*" in .stencila/workflows/workflow-create-run-temporary/
Design the workflow to match the complexity of the goal: The whole point of a workflow is multi-stage orchestration — include agent review stages, human approval gates, iterative revision loops, and branching where the task warrants them Do not optimize for reusability (this is a one-shot ephemeral workflow), but do design for quality — review and iteration stages are what make workflows valuable over single agents For substantial tasks (coding, writing, design), include create-review-revise patterns For simpler tasks, a shorter pipeline is fine — but it should still have at least two meaningful stages, otherwise a single agent would suffice and no workflow is needed Use human gates when the goal involves consequential actions (deployment, publishing, committing) or when the user would reasonably want to approve intermediate results
Set the child workflow's goal in the frontmatter to a clear, actionable description of what the workflow should accomplish. Then store this same goal string into workflow context using workflow_set_contextwith key "child_goal" so the parent workflow can pass it through during execution. Check for validation feedback from a previous attempt using workflow_get_output. If validation errors are present, fix the issues rather than starting from scratch. Also use workflow_get_contextwith key "validation_result" to see the specific validation output. Design the pipeline to use available workspace agents where appropriate. Use list_agentsto see what agents are available. Fall back to general-purpose agents for tasks that do not match a specialist. Keep the workflow's description concise and specific to the goal.
.stencila/workflows/workflow-create-run/WORKFLOW.md