Workflows

Workflows define how things get done at your organization. They represent the business process the agent should follow, not the specific technical steps. Think of them as encoding your team's order of operations so the agent works the way your best engineers work.

Why workflows?

For straightforward requests, the agent does great on its own. For complex work, workflows give you consistency (the same process every time), completeness (no steps get missed), quality (each step can include specific checks and standards), and knowledge capture (your team's best practices, encoded).

How they work

A workflow is a sequence of high-level steps that guides the agent through a process. For example, an "Infrastructure Delivery" workflow might look like this.

  1. Gather functional and nonfunctional requirements
  2. Create a technical architecture plan
  3. Document the security standards and compliance requirements
  4. Write the infrastructure code
  5. Validate the code and confirm it meets the requirements
  6. If validation fails, route back to writing code

The agent takes these process steps and works out the specific technical implementation within the workspace. Based on the requirements, context, and constraints you've provided, it creates a list of tasks and executes against them in order. The workflow tells the agent what the process looks like. The workspace gives it the context to figure out what to build.

Creating workflows

Each workflow needs a name (a clear, descriptive title), a description (what it does and when to use it), and steps (ordered process instructions the agent follows).

Write steps that describe the business process, not the technology. "Document the security standards for this project" is a good workflow step. "Create a Terraform security group with ingress on port 443" is not. That level of detail gets worked out by the agent based on the context in the workspace.

If you want the agent to use a specific capability at a particular step, mention it. For example, "Research current best practices for container security using web search" or "Look up the existing VPC configuration in Terraform Cloud before designing the network." This helps the agent know when to reach for its tools.

The Workflow Registry

Browse community-contributed workflows at infracodebase.com/workflows. You can add them to your enterprise or publish your own.

Managing workflows

From the enterprise Workflows page you can browse available workflows, enable or disable specific workflows, and view workflow details and steps.