Your First Task

Write the task

On the Tasks page, click +. Give the task a title and a markdown description.

For a first run, pick something real but contained: a small bug fix or a well-bounded improvement in a repo you know. Describe the outcome you want and any constraints worth stating. You don’t need to explain where the relevant code lives; finding that is the Researcher’s job.

Set how it should run

Open the task and check the Execution panel on the right. The defaults are fine for a first task: one variant, worktree mode. That means one agent attempt, on its own branch, in an isolated worktree, with your checkout untouched.

Later, try raising Max variants to explore competing solutions to the same task in parallel.

Approve it

In the Workflow panel, set Approval to Approved.

This is the only push the pipeline needs. The Project Manager picks the task up, puts it on the roadmap, and hands it to the Researcher.

Watch it move

Follow progress on the Roadmap board, or inside the task itself:

• The Researcher investigates your code and writes a phased spec for the variant. If it hits a question only you can answer, the task pauses at Needs clarification: read the question in the task thread, reply, and set the roadmap status back to Ready for research.
• The Worker implements the spec phase by phase, committing as it goes.
• The Code-Reviewer reviews the diff and posts findings in the variant’s thread. If it requests changes, the Worker reworks and they loop until the variant is accepted.
• The Reviewer gives the final task-level verdict, and the task lands at Ready for acceptance.

The Runs section lists every agent run on the task. Open one to watch its log live: what the agent is thinking, every tool call, and the final summary.

Review the result

Now it’s your turn:

1. Read the Reviewer’s verdict in the task thread and the Code-Reviewer’s findings in the variant thread.
2. Click Changes on the variant to read the full diff, per project.

Not satisfied? Post what you want changed in the variant’s thread and set the variant’s status to Rework. The Worker picks it up again with your feedback.

Merge and finish

Happy with the diff:

1. Push the variant’s branch to your remote. Agents commit locally but never push.
2. Click Create PR to open a prefilled GitHub compare page, and merge the PR.
3. Set the task’s roadmap status to Accepted.

Done: ticket in, reviewed code out.