Edit a workflow

Change a factory's workflow by chatting with the agent or editing steps directly, then review and apply your changes.

On this page

A workflow is the list of steps every run in a factory goes through. You can change it two ways: describe the change to the agent in the chat pane, or edit steps yourself. Either way, nothing changes for real runs until you apply.

Open the workflow

  1. Open the factory and select the Workflows tab.
  2. Pick a workflow from the workflow menu at the top left. The one marked Factory default is used when a run doesn’t ask for another.
  3. Choose Summary for a readable list of steps, or Graph to see branches.

Built-in workflows (Base Loop, Small change, Large change) are read-only. Copy one into the factory to edit it.

Describe a change in chat

  1. Type what you want in the chat pane on the left. For example: “Add a security review after Implement, and send it back to Implement if it fails.”
  2. Optionally select a step first to attach it to your message.
  3. Read the proposal card that comes back. It lists each change the agent proposes.
  4. Select Review to see before and after, Apply to draft to accept it into your draft, or Dismiss.

The agent never changes the live workflow by itself.

Edit steps directly

Select any step to open the inspector on the right. You can change its name, who does it, its instructions, what counts as done, skills, and whether a person or check must approve before the next step. Select + between steps to add one: an agent step, a check, a human approval, a decision, a notification and more.

Use ⌘ Z to undo and ⇧ ⌘ Z to redo.

Apply your changes

  1. Check the change bar at the top, which shows how many changes you’ve made. If it says there are problems to fix, select it to jump to each one. Problems, such as a step with no instructions, block applying.
  2. Select Review changes. You see every changed step with Before and After, and can revert single fields or whole steps.
  3. Select Apply changes. This creates a new version. New runs use it at once.

Runs already in progress keep the version they started on. Changed your mind before applying? Select Discard. Your draft is saved if you leave the page, so you can come back to it.

Other things you can change

Select the start of the workflow to edit its triggers (what starts a run), limits (budget per run, timeout, concurrent runs) and rules (things agents must never do).

If something goes wrong

  • “Someone applied a new version while you were editing”. Review their changes, choose what to keep, then update to their version and apply.
  • You can’t edit. Only factory owners, admins and workflow editors can change a workflow. Ask an owner for access in the factory’s Access tab.
  • A change broke runs. Roll back to an earlier version; see Roll back a workflow.

The full list of step kinds and settings is in Step kinds.

    Type to search the docs, help center and blog.