Workflows enable users to define a series of steps to guide Cascade through a repetitive set of tasks, such as deploying a service or responding to PR comments.

These Workflows are saved as markdown files, allowing users and their teams an easy repeatable way to run key processes.

Once saved, Workflows can be invoked in Cascade via a slash command with the format of /[name-of-workflow]

How it works

Rules generally provide large language models with guidance by providing persistent, reusable context at the prompt level.

Workflows extend this concept by providing a structured sequence of steps or prompts at the trajectory level, guiding the model through a series of interconnected tasks or actions.

To execute a workflow, users simply invoke it in Cascade using the /[workflow-name] command.

Upon invocation, Cascade sequentially processes each step defined in the workflow, performing actions or generating responses as specified.

How to create a Workflow

To get started with Workflows, click on the Customizations icon in the top right slider menu in Cascade, then navigate to the Workflows panel. Here, you can click on the + Workflow button to create a new Workflow.

Workflows are saved as markdown files within the repository root of .windsurf/workflows/ and contains a title, description, and a series of steps with specific instructions for Cascade to follow.

Generate a Workflow with Cascade

You can also ask Cascade to generate Workflows for you! This works particularly well for workflows involving a series of steps in a particular CLI tool.