Skip to content
rev0Docs

Which tool when

A ticket, a Loop and a Goal can all end with the same diff. What differs is who decides what happens next (you, the agent or a pipeline), how often it runs, and how much you review before anything is written. Picking the wrong one is rarely fatal, but it is the most common reason a run costs more than it should or stops somewhere you did not expect.

I want toUseWhere
Ask something, think out loud, no deliverable yetA chatThe Chats tab. Put it on the board when it turns into work (Ask in Chats).
Get one change done: a bug, a feature, a reportA ticketCreate, Type set to Task (an agent runs it).
Track a piece of a bigger ticket separatelyA subticketCreate with a Parent, or let the agent split it (Split big work).
Group related tickets with no agent of its ownAn epicType set to Epic (no agent, groups subtasks).
Run one skill or slash command, such as a reportA commandType set to Command (runs a /skill), or the Report library (Run a repo report).
Do the same job on a clock, or a pipeline of stepsA LoopType set to Loop (runs on a cron schedule) (Run a Loop).
Keep going until an objective is metA GoalType set to Goal (loops until an objective is met) (Run a Goal).

The Mode field decides whether the agent may start writing straight away.

ChooseWhen
AutoYou could write the acceptance test yourself, and a wrong first attempt is cheap to send back: bug fixes, tests, small features, reports.
A plan modeThe direction is still open, the change touches many places, or a wrong turn is expensive to undo. The agent writes a plan and parks; nothing is edited until you Accept plan.

A plan is the cheapest place to change direction: a comment on a plan costs a paragraph, the same comment on a diff costs a rewrite. See Plans you can point at.

Plan typeMode in the formFits
Text planPlan (verbose text plan first)Backend and refactoring work, where the plan is a list of files and steps. You comment on selected words.
Flow planFlow plan (visual behavior graph)Behaviour with branches: a sign in flow, a state machine, a pipeline. You edit and comment on blocks.
Interactive planInteractive plan (visual)Anything you want to see: a screen, a report layout, a comparison. You annotate any element of an interactive page.

The type an agent picks when it files a plan on its own is Default plan type in Settings > Agents.

SituationUse
One coupled change, even a large oneOne agent. Splitting a coupled change adds handoffs and merge conflicts, not speed.
Many independent targets (every package, every open PR) whose work would not fit one agent’s contextA Loop, one subticket node per target or per batch of targets.
Independent strands that must run in an order, or need a human gate in the middleA Loop: its edges are the order, and a gate parks it for you.
Steps that are not agent work (read GitHub, run a command, post to Slack)A Loop with source, shell and sink nodes, which run no model at all.
The same job repeated until a result is reached, with no fixed number of stepsA Goal.

With orchestration on (Settings > Agents > Orchestration), an agent makes this call itself: it stays solo by default and builds a Loop only for independent strands.

  • The type, mode, model and thinking level of every ticket you create.
  • Whether agents may split work at all, and how many children they may start (Settings > Agents > Orchestration).
  • Every Loop’s pipeline, which you can edit before its first run.
  • A Goal’s caps, which bound it when it never reports that it is done.
  • A command runs one skill and nothing else; for anything open ended, use a task.
  • An epic runs no agent. Its children do the work.
  • A Loop’s children run at the same time unless an edge orders them, so they can conflict when they touch the same files. The orchestrating ticket resolves that when it merges them.
  • A Goal judges “done” by a model reading its ledger. Write the Done when sentence as a test someone could check.
  • The Type and Mode fields of the Create ticket form.
  • A plan card in Pending Action, with Execute by subagent and Execute by loop when orchestration is on.
  • The Loop pipeline and Goal sections of a Loop or Goal ticket.