Valdr Workflows
Valdr Workflows
{"content":"{{\u003c tier level=\"sovereign\" note=\"Valdr Workflows are included with Sovereign for durable, locally operated agent processes.\" \u003e}}\n\nValdr Workflows turn a multi-step process into a versioned definition with durable runs. Compose agents, Valdr Tools, Git actions, trusted commands, reviews, waits, outcome routes, human gates, and child workflows while keeping every run tied to its selected versions and inspectable evidence.\n\n{{\u003c callout type=\"info\" \u003e}}\n**Before you launch:** Sovereign unlocks the durable workflow runtime. Follow the [latest release and pack installation guidance](/valdr/docs/getting-started/configure/#compatible-releases) to import the core pack, then the official **Valdr Workflow pack**, which adds Verdandi and the included workflow definitions. Then configure the provider presets used by the workflow you choose.\n{{\u003c /callout \u003e}}\n\n## Choose an included workflow\n\nThe release pack includes complete entry points plus smaller definitions they compose:\n\n| Start with | Use it when |\n| --- | --- |\n| **Deliver Task** (`valdr-workflow.task.deliver`) | One prepared task should reach verified review without Git closeout |\n| **Deliver And Close Out Task** (`valdr-workflow.task.deliver-and-closeout`) | One prepared task should be reviewed, committed, and marked done |\n| **Create Plan From Task** (`valdr-workflow.plan.from-task`) | You need reviewed specification and plan artifacts with human approval |\n| **Execute Sprint From Tasks** (`valdr-workflow.sprint.from-tasks`) | An existing task set should be prepared, scheduled, delivered, and closed |\n| **Execute Sprint From Plan** (`valdr-workflow.sprint.from-plan`) | An approved Valdr plan should create and deliver a sprint |\n| **Create Pull Request** (`valdr-workflow.pull-request.create`) | An exact branch should be proposed, approved, pushed, and published as a pull request |\n| **Execute Idea Through Sprint** (`valdr-workflow.idea-to-sprint`) | One idea should become an approved plan, completed sprint, and pull request |\n\nOpen **Workflows** in Valdr UI to see the installed versions and required inputs. Supporting definitions remain visible for inspection and composition, but these entry points cover the common end-to-end jobs.\n\n## Learn workflows step by step\n\nStart with how a run works and the core concepts, then [run one prepared task](/valdr/docs/ui/workflows/first-workflow/). The idea-to-sprint walkthrough shows how that grows into a larger process. From there, learn the step types, build your own definitions, and add user tools. Finish with recovery and troubleshooting so you know how to handle interruptions and failures.\n\n{{\u003c cards \u003e}}\n {{\u003c card link=\"how-workflows-run/\" title=\"How Workflows Run\" subtitle=\"Exact revisions, advancement, waits, recovery, cancellation, and deletion\" icon=\"arrows-expand\" \u003e}}\n {{\u003c card link=\"concepts/\" title=\"Concepts\" subtitle=\"Definitions, runs, attempts, waits, outcomes, evidence, and recovery\" icon=\"book-open\" \u003e}}\n {{\u003c card link=\"/valdr/docs/ui/workflows/first-workflow/\" title=\"Run Your First Workflow\" subtitle=\"Deliver and review one prepared task without writing YAML\" icon=\"play\" \u003e}}\n {{\u003c card link=\"idea-to-sprint/\" title=\"From Idea to Verified Sprint\" subtitle=\"See planning, approval, reviewed Git integration, sprint close, and pull-request publication as one lifecycle\" icon=\"check-circle\" \u003e}}\n {{\u003c card link=\"steps/\" title=\"Workflow Steps\" subtitle=\"Choose actions, agents, reviews, approvals, and reusable workflows\" icon=\"menu\" \u003e}}\n {{\u003c card link=\"definition-authoring/\" title=\"Definition Authoring\" subtitle=\"Author and validate workflow YAML for packs\" icon=\"pencil-alt\" \u003e}}\n {{\u003c card link=\"user-tools/\" title=\"Build User Tools\" subtitle=\"Turn your scripts and CLIs into typed, version-pinned workflow steps\" icon=\"code\" \u003e}}\n {{\u003c card link=\"reliability-and-recovery/\" title=\"Reliability and Recovery\" subtitle=\"Understand version stability, restart recovery, evidence, retries, reruns, and deletion\" icon=\"shield-check\" \u003e}}\n {{\u003c card link=\"troubleshooting/\" title=\"Troubleshooting\" subtitle=\"Diagnose builder, launch, wait, retry, rerun, and import problems\" icon=\"support\" \u003e}}\n {{\u003c card link=\"/valdr/docs/ui/workflows/\" title=\"Workflow UI\" subtitle=\"Use the catalog, builder, run inspector, and human gates\" icon=\"desktop-computer\" \u003e}}\n{{\u003c /cards \u003e}}\n\nFor the product overview, read [Durable Workflows](/valdr/docs/features/workflows/). For programmatic operations, use the [pm_workflow MCP reference](/valdr/docs/valdr-mcp/workflows/).\n\n## Next step\n\nRead [How Workflows Run](how-workflows-run/) to follow a run from launch through steps, waits, and results.","description":"Build, compose, and operate durable agent processes with selected versions, evidence, recovery, and human authority.","title":"Valdr Workflows"}
Sovereign
Sovereign tier required. Valdr Workflows are included with Sovereign for durable, locally operated agent processes.
Valdr Workflows turn a multi-step process into a versioned definition with durable runs. Compose agents, Valdr Tools, Git actions, trusted commands, reviews, waits, outcome routes, human gates, and child workflows while keeping every run tied to its selected versions and inspectable evidence.
Before you launch: Sovereign unlocks the durable workflow runtime. Follow the latest release and pack installation guidance to import the core pack, then the official Valdr Workflow pack, which adds Verdandi and the included workflow definitions. Then configure the provider presets used by the workflow you choose.
Choose an included workflow
The release pack includes complete entry points plus smaller definitions they compose:
| Start with | Use it when |
|---|---|
Deliver Task (valdr-workflow.task.deliver) | One prepared task should reach verified review without Git closeout |
Deliver And Close Out Task (valdr-workflow.task.deliver-and-closeout) | One prepared task should be reviewed, committed, and marked done |
Create Plan From Task (valdr-workflow.plan.from-task) | You need reviewed specification and plan artifacts with human approval |
Execute Sprint From Tasks (valdr-workflow.sprint.from-tasks) | An existing task set should be prepared, scheduled, delivered, and closed |
Execute Sprint From Plan (valdr-workflow.sprint.from-plan) | An approved Valdr plan should create and deliver a sprint |
Create Pull Request (valdr-workflow.pull-request.create) | An exact branch should be proposed, approved, pushed, and published as a pull request |
Execute Idea Through Sprint (valdr-workflow.idea-to-sprint) | One idea should become an approved plan, completed sprint, and pull request |
Open Workflows in Valdr UI to see the installed versions and required inputs. Supporting definitions remain visible for inspection and composition, but these entry points cover the common end-to-end jobs.
Learn workflows step by step
Start with how a run works and the core concepts, then run one prepared task. The idea-to-sprint walkthrough shows how that grows into a larger process. From there, learn the step types, build your own definitions, and add user tools. Finish with recovery and troubleshooting so you know how to handle interruptions and failures.
Exact revisions, advancement, waits, recovery, cancellation, and deletion
Definitions, runs, attempts, waits, outcomes, evidence, and recovery
Deliver and review one prepared task without writing YAML
See planning, approval, reviewed Git integration, sprint close, and pull-request publication as one lifecycle
Choose actions, agents, reviews, approvals, and reusable workflows
Author and validate workflow YAML for packs
Turn your scripts and CLIs into typed, version-pinned workflow steps
Understand version stability, restart recovery, evidence, retries, reruns, and deletion
Diagnose builder, launch, wait, retry, rerun, and import problems
Use the catalog, builder, run inspector, and human gates
For the product overview, read Durable Workflows. For programmatic operations, use the pm_workflow MCP reference.
Next step
Read How Workflows Run to follow a run from launch through steps, waits, and results.