Your first workflow

This page builds one small workflow — investigate a bug report, then stop for your review — and runs it. It takes a few minutes and covers every part of the builder you will use again.

Create the workflow

Open Workflows and choose New workflow → Blank workflow. Give it a title, Bug investigation.

Leave Default repository unset so each run picks one.

Declare an input

Under Inputs, add one required input named report, described as "the bug report to investigate". Prompts read it as @input:report.

Add a context document

Under Context docs, add a document with the slug findings. Give it a starting body:

# Findings
 
## Evidence

You will point the writing step at it in a moment.

Add two steps

From the Add step rail, add an Agent step and a Human in the loop step, then connect Inputs → Agent → Human.

Select the agent step and fill it in:

• Title — Research
• Prompt — Investigate @input:report. Read the code, do not guess. Record what you find in @doc:findings with file-and-line evidence.

Go back to the document you added and set Written by to this step.

Select the human step:

• Title — Review the findings
• Prompt — Read @doc:findings. Approve if the diagnosis is supported by evidence.

The canvas status readout should now say Valid. Press Save Workflow.

Run it

Press Run, fill in report, pick a repository, and leave the placement on New worktree. The run opens a workspace with the Execution panel on the right.

The research step starts immediately. Open its session to watch it work, or open findings under Documents to read what it has written so far.

When it finishes, the run stops on the human step and marks it Needs input. Read the document, then Approve to finish the run — or Fail & redo the research step with a sharper prompt.

Where to go next