> For the complete documentation index, see [llms.txt](https://docs.warp.dev/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Warp Factories overview

Warp Factories runs teams of cloud agents that take work from Slack, GitHub, Linear, or Jira through triage, spec, implementation, and review.

A factory is a team of cloud agents attached to a set of repositories. Work arrives as a Slack message, a GitHub issue, a Linear or Jira ticket, or a scheduled job. A coordinating agent called the foreman routes each request through triage, spec, implementation, and review, and the result comes back where the work started, usually as a pull request. For example, a factory can work through a backlog of issues, fix defects reported in a support channel, or review incoming pull requests across several repositories.

People stay in the loop at the points that matter: approving a spec, answering the foreman’s questions, and merging.

[Get started with Warp Factories](https://www.warp.dev/get-started)For prospective users and teams new to Warp Factories.

[Open Warp Factories](https://platform.warp.dev)For existing users and teams already using Warp Factories.

![Introducing Warp Factories](https://i.ytimg.com/vi/0WBk4ai8y1A/sddefault.jpg)

![A circular diagram of the software factory loop: triage, spec, implement, review, verify, ship, and monitor, with human review checkpoints for the spec, code, and product.](https://docs.warp.dev/_astro/factories-concept-loop.D5J0xtAi_PLdIR.webp?dpl=dpl_6fHhN5C1TLxbrXHruCQA6auyAhDb)

The software factory loop. The default agents cover triage through review.

## The parts of a factory

### Work items

A work item is one request the factory acts on: an issue, a support thread, a pull request, or a scheduled job. It keeps its source context from intake to handoff, however many agents contribute along the way.

### Foreman and factory agents

Every factory has one foreman, the agent you talk to. It decides which agent a work item goes to next, asks you when it needs a decision, and hands back the finished pull request. Behind it are the default triage, spec, implement, and review agents; add custom agents for work they don’t cover. Each agent can run on its own model and harness, including the Warp Agent, Claude Code, and Codex. See [factory agents](https://docs.warp.dev/factories/factory-agents/).

Setup gives the foreman the same handle as the factory, so `payments` is the factory and `@payments` reaches its foreman from Slack or Linear. See [Foreman name](https://docs.warp.dev/factories/factory-agents/#foreman-name).

### Stages and checkpoints

The foreman moves a work item through the Triage, Planning, Building, and Reviewing stages, skipping the ones a well-defined request doesn’t need and sending work back when review finds problems. Spec approval and the foreman’s questions are written into its instructions, which your team can edit. Merging is enforced by your repository’s branch protection. See [how Warp Factories work](https://docs.warp.dev/factories/how-factories-work/).

### Factory definition

A factory’s repositories, agents, automations, runners, skills, and MCP servers are declared in definition files, either managed by Warp or stored in a GitHub repository your team owns. Changes to a GitHub-backed factory go through pull request review like any other code. See [definitions as code](https://docs.warp.dev/factories/factory-as-code/).

### Work sources

Connect [Slack](https://docs.warp.dev/factories/integrations/slack/), [Microsoft Teams](https://docs.warp.dev/factories/integrations/teams/), [GitHub](https://docs.warp.dev/factories/integrations/github/), [GitLab](https://docs.warp.dev/factories/integrations/gitlab/), [Azure DevOps](https://docs.warp.dev/factories/integrations/azure-devops/), [Linear](https://docs.warp.dev/factories/integrations/linear/), or [Jira](https://docs.warp.dev/factories/integrations/jira/), and the factory posts results back in the same thread, issue, or pull request. [Custom webhooks](https://docs.warp.dev/factories/webhooks/) and [factory endpoints](https://docs.warp.dev/factories/factory-api/) cover other systems, schedules start recurring work, and the [Factory MCP](https://docs.warp.dev/factories/factory-mcp/) lets a local coding agent hand work to a factory and take it back. See [connect your factory](https://docs.warp.dev/factories/connect-your-factory/).

### Execution

Every agent run in a factory is an ordinary [cloud agent run](https://docs.warp.dev/platform/) on the Automation Platform. Runs execute on Warp-hosted compute by default; Enterprise teams can keep checkout and execution on their own infrastructure with [managed self-hosting](https://docs.warp.dev/factories/self-hosting/). See [infrastructure and security](https://docs.warp.dev/factories/infrastructure-and-security/) for runners, inference, and credential boundaries.

### Measurement

The [factory dashboard](https://docs.warp.dev/factories/factory-dashboard/) shows work items by stage, runs, and cost per pull request. [Scorers](https://docs.warp.dev/factories/measure-and-improve/scorers/) classify completed runs against criteria you write, [benchmarks](https://docs.warp.dev/factories/benchmarks/) compare models, harnesses, and runners on the same tasks, and [Self-improvement](https://docs.warp.dev/factories/measure-and-improve/self-improvement/) turns repeated failures into pull requests for your review. See [measure and improve](https://docs.warp.dev/factories/measure-and-improve/).

## Sizing a factory

Group the repositories that ship together into one factory, and keep separate products in separate factories. For example:

-   One factory for your main application
-   One factory for your marketing site
-   One factory for your data pipelines

Don’t split the same repositories across factories by team or task, such as frontend and platform. Add [agents](https://docs.warp.dev/factories/factory-agents/) and [skills](https://docs.warp.dev/factories/factory-skills/) to specialize instead.

## Related pages

-   [Warp Factories quickstart](https://docs.warp.dev/factories/quickstart/) - Create a factory and send its first work item.
-   [How Warp Factories work](https://docs.warp.dev/factories/how-factories-work/) - The work-item lifecycle, stage by stage.
-   [Factory agents](https://docs.warp.dev/factories/factory-agents/) - What each default agent does and how to configure its model and harness.
-   [Definitions as code](https://docs.warp.dev/factories/factory-as-code/) - The definition file format, with working examples in [warp-factory-examples](https://github.com/warpdotdev/warp-factory-examples).