glossary · The process

Workflow router

definition

A workflow router is a single entry workflow that every new piece of work starts on: the agent triages the work, a decision picks one exit, and the matching sub-workflow runs before the router completes.

in one line: One door for new work. A decision picks the exit.

in context

Where does a workflow router fit?

Every new task. One door. The agent triages the work, picks one exit, and records why.

triagewhat is this?
routefour exits
sub-workflowruns, returns
capturewhat was learned
complete
two ways to say it

What is a workflow router, in plain words?

Same idea at two depths: the plain version, then what the engine actually does.

Choosing the right process becomes a step of its own, done with the work in front of the agent.

Each exit leads to a small workflow that only handles its own kind of work.

for engineers

Owners and admins mark one template is_router. It attaches on create for tasks, bugs, initiatives and plans.

An explicit workflow on create wins. Without a router, rules match by type, area, tags and project.

the longer answer

Why does a workflow router matter?

Without a router, choosing the right process is someone's job at creation time. A person picks a template, or a rule matches on fields like type or tags. That works until the categories blur: a "task" that is really a code change needing review, a "bug" that is actually infrastructure. A router turns that choice into a step of its own, done by the agent with the work in front of it, and recorded.

The pattern has three parts. A triage step confirms what kind of work this is. A decision step offers a small number of exits, each naming the sub-workflow it starts, such as feature delivery, a code change with review, a small known task, or an operations change. After the chosen sub-workflow finishes, control returns to the router, which can run closing steps that apply to all work, like capturing what was learned.

Routers keep each downstream workflow small and specific, because none of them has to handle every case. They also make the routing auditable: the decision records which exit was taken and why, so a reviewer can see that a change went through the review path and not the quick one.

in convops

How does a workflow router work in ConvOps?

In ConvOps, a workspace can mark one workflow as its router. Owners and admins set it. When a new task, bug, initiative or plan is created, the router attaches directly; phases, goals, ideas and scheduled work keep their own matching rules. Naming a workflow explicitly when the work is created skips the router. Without a router, rules match new work to a workflow by type, area, tags and project. A router exit can also match a task field automatically, for example sending every initiative to feature delivery, so the agent decides only the cases that need judgment.

questions

What do people ask about a workflow router?

What does a workflow router do?

It takes new work, decides which process fits, and starts that process as a sub-workflow. The decision is a step made by the agent with the work in front of it, and it is recorded, so the chosen path can be reviewed later.

When should I use a router instead of matching rules?

When categories blur: a task that is really a reviewed code change, a bug that is really infrastructure. Rules match on fields; a router lets the agent judge the work. In ConvOps a router exit can still match a field automatically for the clear cases.

Who sets the router in ConvOps?

Owners and admins mark one workflow per workspace as its router. Naming a workflow explicitly when the work is created skips the router.