glossary · The process

Workflow fragment

definition

A workflow fragment is a reusable block of steps written once and embedded in many workflows, so a change to the fragment reaches every workflow that uses it.

in one line: Shared steps written once, embedded in many workflows.

in context

Where does a workflow fragment fit?

Edit once. Every workflow changes. The same build-and-verify block, embedded where it is needed.

build-and-verifywritten once
Developmentembeds it
Ops taskembeds it
One fragment, many workflows. Example.
two ways to say it

What is a workflow fragment, in plain words?

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

Copies drift. A fragment keeps a common block of steps in one place.

Use a fragment for steps that always run. Use a sub-workflow for work that only sometimes happens.

for engineers

A step entry embeds a fragment by name. Fragments are resolved when the workflow is read.

Workspace globals add steps to every workflow. Fragments are unlimited on every plan.

the longer answer

Why does a workflow fragment matter?

Most organizations have steps that appear in many processes: find the standards that apply, build and verify, run a review, capture what was learned. When each workflow carries its own copy, the copies drift. One team adds a lint step, another does not, and six months later "the review step" means five different things. Fragments solve the same problem functions solve in code: write it once, call it everywhere. The same pattern holds outside engineering: a legal check or a brand review used by many content workflows.

A fragment is not a sub-workflow. A sub-workflow is a detour a decision starts at run time, with its own instance and a parent that waits. A fragment is inlined into the workflow that embeds it; its steps simply become part of the line. Use a fragment for steps that always run in that position, and a sub-workflow for work that only happens on some paths.

The design discipline is to keep fragments narrow and outcome-shaped. A fragment called build-and-verify with three clear steps is easy to reuse. A fragment that tries to cover every variant of a process becomes a second monolith.

in convops

How does a workflow fragment work in ConvOps?

In ConvOps, a workflow lists steps, and an entry can embed a fragment by name. Fragments are resolved when the workflow is read, so an edit to a fragment applies to every workflow that embeds it, including runs that reach those steps later. Workspace globals work alongside fragments: they add steps to every workflow, such as a closing step that captures learnings, without editing each template. Fragments are unlimited on every plan, including Free. You create and edit them the same way as workflows, by asking your AI client over MCP. A fragment cannot drift from itself, which is the whole point.

questions

What do people ask about a workflow fragment?

When should I use a workflow fragment?

When the same steps appear in several workflows, such as build and verify, a review, or a legal check. Write them once as a fragment and embed it, so every workflow runs the same version.

Do fragment edits affect workflows that are already running?

Yes, in ConvOps. Fragments are resolved when the workflow is read, so an edit applies to every workflow that embeds it, including runs that reach those steps later.

Are workflow fragments limited by plan?

No. Fragments are unlimited on every ConvOps plan, including Free.