# Valdr Workflows
{{< tier level="sovereign" note="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.

{{< callout type="info" >}}
**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.
{{< /callout >}}

## 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](/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.

{{< cards >}}
  {{< card link="how-workflows-run/" title="How Workflows Run" subtitle="Exact revisions, advancement, waits, recovery, cancellation, and deletion" icon="arrows-expand" >}}
  {{< card link="concepts/" title="Concepts" subtitle="Definitions, runs, attempts, waits, outcomes, evidence, and recovery" icon="book-open" >}}
  {{< 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" >}}
  {{< 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" >}}
  {{< card link="steps/" title="Workflow Steps" subtitle="Choose actions, agents, reviews, approvals, and reusable workflows" icon="menu" >}}
  {{< card link="definition-authoring/" title="Definition Authoring" subtitle="Author and validate workflow YAML for packs" icon="pencil-alt" >}}
  {{< card link="user-tools/" title="Build User Tools" subtitle="Turn your scripts and CLIs into typed, version-pinned workflow steps" icon="code" >}}
  {{< card link="reliability-and-recovery/" title="Reliability and Recovery" subtitle="Understand version stability, restart recovery, evidence, retries, reruns, and deletion" icon="shield-check" >}}
  {{< card link="troubleshooting/" title="Troubleshooting" subtitle="Diagnose builder, launch, wait, retry, rerun, and import problems" icon="support" >}}
  {{< card link="/valdr/docs/ui/workflows/" title="Workflow UI" subtitle="Use the catalog, builder, run inspector, and human gates" icon="desktop-computer" >}}
{{< /cards >}}

For the product overview, read [Durable Workflows](/valdr/docs/features/workflows/). For programmatic operations, use the [pm_workflow MCP reference](/valdr/docs/valdr-mcp/workflows/).

## Next step

Read [How Workflows Run](how-workflows-run/) to follow a run from launch through steps, waits, and results.