# 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. Import the official **Valdr Workflow pack** to add Verdandi and the included workflow definitions. The [compatibility table](/valdr/docs/getting-started/configure/#compatible-releases) lists the exact versions and filenames. Then configure the launcher 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 |
| --- | --- |
| **Execute Idea Through Sprint** (`valdr-workflow.idea-to-sprint`) | One idea should become an approved plan, completed sprint, and pull request |
| **Create Plan From Task** (`valdr-workflow.plan.from-task`) | You need reviewed specification and plan artifacts with human approval |
| **Execute Sprint From Plan** (`valdr-workflow.sprint.from-plan`) | An approved Valdr plan should create and deliver a sprint |
| **Execute Sprint From Tasks** (`valdr-workflow.sprint.from-tasks`) | An existing task set should be prepared, scheduled, delivered, and closed |
| **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 Pull Request** (`valdr-workflow.pull-request.create`) | An exact branch should be proposed, approved, pushed, and published as a 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.

{{< cards >}}
  {{< 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="concepts/" title="Concepts" subtitle="Definitions, runs, attempts, waits, outcomes, evidence, and recovery" icon="book-open" >}}
  {{< card link="how-workflows-run/" title="How Workflows Run" subtitle="Exact revisions, advancement, waits, recovery, cancellation, and deletion" icon="arrows-expand" >}}
  {{< 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="definition-authoring/" title="Definition Authoring" subtitle="Author and validate workflow YAML for packs" icon="pencil-alt" >}}
  {{< card link="steps/" title="Workflow Steps" subtitle="Reference the seven supported workflow step kinds" icon="menu" >}}
  {{< 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/).

