From 0f8dcb650e13a548778cc6a7358669d63cacb926 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 06:02:50 +0000 Subject: [PATCH 01/16] docs: route factory acquisition through get started Co-Authored-By: Oz --- src/content/docs/factories/benchmarks.mdx | 2 +- src/content/docs/factories/factory-agents.mdx | 3 ++- src/content/docs/factories/factory-api.mdx | 2 +- src/content/docs/factories/factory-skills.mdx | 3 ++- src/content/docs/factories/how-factories-work.mdx | 3 ++- src/content/docs/factories/index.mdx | 2 +- src/content/docs/factories/integrations/azure-devops.mdx | 2 +- src/content/docs/factories/quickstart.mdx | 4 ++-- src/content/docs/factories/troubleshooting.mdx | 2 +- .../guides/agent-workflows/build-a-self-improving-agent.mdx | 2 +- .../docs/guides/agent-workflows/build-a-triage-agent.mdx | 2 +- .../agent-workflows/run-a-software-factory-in-the-cloud.mdx | 2 +- .../write-product-and-tech-specs-with-agents.mdx | 2 +- src/content/docs/platform/overview.mdx | 2 +- src/data/vars.ts | 1 + 15 files changed, 19 insertions(+), 15 deletions(-) diff --git a/src/content/docs/factories/benchmarks.mdx b/src/content/docs/factories/benchmarks.mdx index 7f21eddcb..7ad16d173 100644 --- a/src/content/docs/factories/benchmarks.mdx +++ b/src/content/docs/factories/benchmarks.mdx @@ -10,7 +10,7 @@ import { VARS } from '@data/vars'; import VideoEmbed from '@components/VideoEmbed.astro'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: Warp Factories benchmarks compare model and runner configurations for one factory agent on the same fixed tasks. Use a benchmark to test a change on representative work before you apply it to your factory. diff --git a/src/content/docs/factories/factory-agents.mdx b/src/content/docs/factories/factory-agents.mdx index d6c71f9f5..f3d983227 100644 --- a/src/content/docs/factories/factory-agents.mdx +++ b/src/content/docs/factories/factory-agents.mdx @@ -6,9 +6,10 @@ description: >- sidebar: label: "Factory agents" --- +import { VARS } from '@data/vars'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: Every factory has a **foreman**, the agent you talk to from the tool that sends the request, such as Slack or Linear. Four other default agents each cover one part of the software development lifecycle: triage scopes the request, spec writes the plan, implement writes the code, and review checks it. Together they take a work item from the moment it reaches your factory to a pull request ready for review. diff --git a/src/content/docs/factories/factory-api.mdx b/src/content/docs/factories/factory-api.mdx index a660a867e..aaa441995 100644 --- a/src/content/docs/factories/factory-api.mdx +++ b/src/content/docs/factories/factory-api.mdx @@ -11,7 +11,7 @@ import { VARS } from '@data/vars'; The factory endpoints are part of the {VARS.WARP_PLATFORM_API}. Use them to find a factory and start work from a custom integration without managing agent details. Build them into a chat bot, script, or service for any tool Warp doesn't connect to directly. :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: ## How it works diff --git a/src/content/docs/factories/factory-skills.mdx b/src/content/docs/factories/factory-skills.mdx index 5135d59ff..792b13ffa 100644 --- a/src/content/docs/factories/factory-skills.mdx +++ b/src/content/docs/factories/factory-skills.mdx @@ -6,9 +6,10 @@ description: >- sidebar: label: "Factory skills" --- +import { VARS } from '@data/vars'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: A skill tells an agent what to check, how to classify results, what to produce, and when to escalate. In a factory, skills are how you extend or override [default agents](/factories/factory-agents/), without editing their prompts directly. diff --git a/src/content/docs/factories/how-factories-work.mdx b/src/content/docs/factories/how-factories-work.mdx index 435685dcb..871eb5c3a 100644 --- a/src/content/docs/factories/how-factories-work.mdx +++ b/src/content/docs/factories/how-factories-work.mdx @@ -6,9 +6,10 @@ description: >- sidebar: label: "How factories work" --- +import { VARS } from '@data/vars'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: A factory is a fleet of agents wired to your software development lifecycle. It connects your repositories and tools to move requests through triage, specification, implementation, review, and verification, while people stay in control of key decisions. You talk to one agent, the **foreman**, from the tool that sends the request, such as Slack or Linear. The foreman dispatches the factory's other agents, and each one owns a part of the software development lifecycle. diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index d36427bf6..4a5302f69 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -10,7 +10,7 @@ import { VARS } from '@data/vars'; import VideoEmbed from '@components/VideoEmbed.astro'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. If your team already has access, sign in to the {VARS.FACTORY_WEB_APP}. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. If your team already has access, sign in to the {VARS.FACTORY_WEB_APP}. ::: A factory is a group of agents that shares repositories and delivery policy. Its foreman accepts work from connected tools, dispatches the right agents, and returns the result to the source. diff --git a/src/content/docs/factories/integrations/azure-devops.mdx b/src/content/docs/factories/integrations/azure-devops.mdx index a61bb40c3..697fa0b1e 100644 --- a/src/content/docs/factories/integrations/azure-devops.mdx +++ b/src/content/docs/factories/integrations/azure-devops.mdx @@ -11,7 +11,7 @@ import { VARS } from '@data/vars'; Connect Azure DevOps Services to a factory so agents can work in selected repositories, open pull requests, and start runs from work item and pull request events. Warp creates a dedicated Microsoft Entra identity for each factory's Git and pull request operations. :::note -Warp Factories is in Early Access and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in Early Access and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: The first-class integration supports hosted Azure DevOps Services at `dev.azure.com`. It doesn't support Azure DevOps Server. To use a self-hosted Azure DevOps Server repository, [configure it as another code forge](/factories/code-forges/other-code-forges/). For standalone cloud agent environments, use the [Azure DevOps access token setup](/platform/integrations/azure-devops/). diff --git a/src/content/docs/factories/quickstart.mdx b/src/content/docs/factories/quickstart.mdx index a26486473..55cd5b799 100644 --- a/src/content/docs/factories/quickstart.mdx +++ b/src/content/docs/factories/quickstart.mdx @@ -9,7 +9,7 @@ sidebar: import { VARS } from '@data/vars'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. ::: Create a factory and take one small work item from prompt to pull request in about 10 minutes. This quickstart is for teams that already have Warp Factories access and know which repositories they want the factory to use. @@ -17,7 +17,7 @@ Create a factory and take one small work item from prompt to pull request in abo ## Prerequisites -* **Warp Factories access** - [Request Early Access](https://www.warp.dev/factories/request-access) for your team. +* **Warp Factories access** - If your team doesn't already have access, get started with Warp Factories. * **A Warp team with credits** - The team's [credits](/support-and-community/plans-and-billing/platform-credits/) are consumed by factory agents. * **Repository access** - Authorize GitHub, GitLab, or Azure DevOps during setup. Restricted organizations need owner approval. Azure DevOps also requires [one-time administrator approval](/factories/integrations/azure-devops/#requirements). diff --git a/src/content/docs/factories/troubleshooting.mdx b/src/content/docs/factories/troubleshooting.mdx index a021a649c..097d4b8e2 100644 --- a/src/content/docs/factories/troubleshooting.mdx +++ b/src/content/docs/factories/troubleshooting.mdx @@ -16,7 +16,7 @@ Fix the problems teams hit most often when setting up a factory and running thei **Cause:** Warp Factories is in Early Access and enabled per team. -**Fix:** [Request access](https://www.warp.dev/factories/request-access) for your team. If a teammate already has it, ask a team admin to confirm you're on that team. +**Fix:** If your team is new to Warp Factories, get started with Warp Factories. If a teammate already has access, ask a team admin to confirm you're on that team. ### A repository doesn't appear in the picker diff --git a/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx b/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx index 3b6b9128b..eeb7e8f4b 100644 --- a/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx +++ b/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx @@ -24,7 +24,7 @@ The outer loop proposes improvements; it doesn't apply them silently. Every chan ## Prerequisites * A working inner loop with at least one agent running ([set up your software factory](/guides/agent-workflows/set-up-a-software-factory)) -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account (get started with Warp) * A cloud environment with access to your repository ([create one](/platform/environments)) ## Why principles beat rules diff --git a/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx b/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx index af83db49c..50dab8478 100644 --- a/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx +++ b/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx @@ -15,7 +15,7 @@ Learn how to use the {VARS.WARP_AUTOMATION_PLATFORM} to build a triage agent tha ## Prerequisites -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account (get started with Warp) * A GitHub repository with Issues enabled * A cloud environment with access to your repository ([create one](/platform/environments/configuring-environments/#create-an-environment-with-guided-setup)) * A Warp API key added to your CI secrets as `WARP_API_KEY` ([create one](/agents/cli/oz-cli/api-keys/#from-the-web-app-recommended)) diff --git a/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx b/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx index 511fe9544..e905f8cc8 100644 --- a/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx +++ b/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx @@ -18,7 +18,7 @@ The GitHub Actions approach in [Set up your software factory](/guides/agent-work ## Prerequisites * A working software factory loop ([set one up](/guides/agent-workflows/set-up-a-software-factory)) -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account (get started with Warp) ## Why cloud agents, not cloud computers diff --git a/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx b/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx index f0983809b..8575b2edd 100644 --- a/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx +++ b/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx @@ -18,7 +18,7 @@ Specs give implementation agents the context they need to make good decisions, a ## Prerequisites -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account (get started with Warp) * A triaged issue labeled `ready-to-spec` or equivalent ([set up triaging](/guides/agent-workflows/build-a-triage-agent)) * `common-skills` installed globally from [`warpdotdev/common-skills`](https://github.com/warpdotdev/common-skills): diff --git a/src/content/docs/platform/overview.mdx b/src/content/docs/platform/overview.mdx index aa656eee6..7eeb7e227 100644 --- a/src/content/docs/platform/overview.mdx +++ b/src/content/docs/platform/overview.mdx @@ -66,7 +66,7 @@ Runs pick up your team's shared setup no matter what triggered them: [MCP server ## Warp Factories -[Warp Factories](/factories/) builds on these pieces to run persistent, multi-agent development workflows: specialized cloud agents move each work item through triage, specification, implementation, and review. It's in Early Access. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +[Warp Factories](/factories/) builds on these pieces to run persistent, multi-agent development workflows: specialized cloud agents move each work item through triage, specification, implementation, and review. It's in Early Access. If your team is new to Warp Factories, get started with Warp Factories. ## Where to go next diff --git a/src/data/vars.ts b/src/data/vars.ts index 1fbc605e3..bb21274c5 100644 --- a/src/data/vars.ts +++ b/src/data/vars.ts @@ -67,5 +67,6 @@ export const VARS = { ADD_ON_CREDITS: "Add-on Credits", // URLs + GET_STARTED_URL: "https://www.warp.dev/get-started", CONTACT_SALES_URL: "https://www.warp.dev/contact-sales", } as const; From a7dae33a8ad8f64c2e50218ebef3826d8e14e802 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 16:28:25 +0000 Subject: [PATCH 02/16] docs: prepare Warp Factories for general availability Remove obsolete access gating and align setup, benchmark, and self-improvement guidance with current behavior. Co-Authored-By: Oz --- src/components/WarpTopicNav.astro | 9 ++++----- src/content/docs/factories/benchmarks.mdx | 8 ++------ .../docs/factories/connect-your-factory.mdx | 2 +- src/content/docs/factories/factory-agents.mdx | 4 ---- src/content/docs/factories/factory-api.mdx | 4 ---- src/content/docs/factories/factory-skills.mdx | 4 ---- src/content/docs/factories/how-factories-work.mdx | 4 ---- src/content/docs/factories/index.mdx | 4 ---- .../docs/factories/integrations/azure-devops.mdx | 6 +----- src/content/docs/factories/integrations/jira.mdx | 8 +++++--- src/content/docs/factories/integrations/teams.mdx | 15 +++------------ .../measure-and-improve/self-improvement.mdx | 4 +++- src/content/docs/factories/quickstart.mdx | 14 ++++---------- src/content/docs/factories/troubleshooting.mdx | 6 +++--- .../build-a-self-improving-agent.mdx | 2 +- .../agent-workflows/build-a-triage-agent.mdx | 2 +- .../run-a-software-factory-in-the-cloud.mdx | 4 ++-- .../write-product-and-tech-specs-with-agents.mdx | 2 +- src/content/docs/index.mdx | 2 +- src/content/docs/platform/overview.mdx | 2 +- src/sidebar.ts | 2 -- 21 files changed, 33 insertions(+), 75 deletions(-) diff --git a/src/components/WarpTopicNav.astro b/src/components/WarpTopicNav.astro index d3bc29508..97b6fdea1 100644 --- a/src/components/WarpTopicNav.astro +++ b/src/components/WarpTopicNav.astro @@ -25,11 +25,10 @@ // underline share `--sl-color-text-accent`, which auto-adapts to dark // and light themes. // - No surrounding chip / box / bg — just type + icon -// - Topic badge (e.g. Factories "Early Access"): rendered as a plain span -// styled as a compact brand pill (Inter, 11px/600, accent tint, fully -// rounded) instead of Starlight's ``, whose monospace bordered -// box clashed with the nav type and was wide enough to wrap the nav -// onto a second row at common laptop widths. +// - Topic badges render as compact brand pills (Inter, 11px/600, accent +// tint, fully rounded) instead of Starlight's ``, whose bordered +// monospace box clashed with the nav type and was wide enough to wrap the +// nav onto a second row at common laptop widths. import { Icon } from '@astrojs/starlight/components'; const { topics } = Astro.locals.starlightSidebarTopics; diff --git a/src/content/docs/factories/benchmarks.mdx b/src/content/docs/factories/benchmarks.mdx index 7f21eddcb..a4a38980b 100644 --- a/src/content/docs/factories/benchmarks.mdx +++ b/src/content/docs/factories/benchmarks.mdx @@ -9,11 +9,7 @@ sidebar: import { VARS } from '@data/vars'; import VideoEmbed from '@components/VideoEmbed.astro'; -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - -Warp Factories benchmarks compare model and runner configurations for one factory agent on the same fixed tasks. Use a benchmark to test a change on representative work before you apply it to your factory. +Warp Factories benchmarks compare model, harness, and runner configurations for one factory agent on the same fixed tasks. Use a benchmark to test a change on representative work before you apply it to your factory. This video shows how to compare benchmark results for quality and cost before changing a coding agent's configuration. @@ -67,7 +63,7 @@ This video shows how to turn your team's coding tasks into a reusable benchmark ![The task editor with fields for a title, prompt, correctness criteria, and pinned repositories.](../../../assets/factories/benchmark-task-editor.png)
The task editor for a benchmark suite.
-6. Click **Run**. In the launch dialog, choose the model or an authorized custom factory router and the runner for each configuration. Third-party harness comparisons are not available yet. +6. Click **Run**. In the launch dialog, choose the harness and model, or an authorized custom factory router, and the runner for each configuration. 7. Add configurations, select Scorers, and set "Repetitions." The dialog shows the number of trials created. More trials and Scorers increase the run's cost. 8. Click **Run benchmark**. The benchmark page shows its status and scored trials. You can cancel a running or scoring benchmark. diff --git a/src/content/docs/factories/connect-your-factory.mdx b/src/content/docs/factories/connect-your-factory.mdx index 29a56f447..b34ef6cd4 100644 --- a/src/content/docs/factories/connect-your-factory.mdx +++ b/src/content/docs/factories/connect-your-factory.mdx @@ -15,7 +15,7 @@ GitHub, GitLab.com, and Azure DevOps Services connect both repositories and prov ## Choose a source -Pick the sources that match where work starts for your team. You can connect multiple sources, but not both Linear and Jira at the same time. The setup wizard currently offers Linear; to use Jira, connect it after setup or in your [factory definition](/factories/factory-as-code/). +Pick the sources that match where work starts for your team. You can connect multiple sources, but not both Linear and Jira at the same time. Choose either issue tracker during setup, or connect one later from the factory's settings or [definition](/factories/factory-as-code/). Once a source is connected, here's the concrete action that hands it work — each links to that integration's full instructions rather than repeating them. diff --git a/src/content/docs/factories/factory-agents.mdx b/src/content/docs/factories/factory-agents.mdx index d6c71f9f5..ad7510bec 100644 --- a/src/content/docs/factories/factory-agents.mdx +++ b/src/content/docs/factories/factory-agents.mdx @@ -7,10 +7,6 @@ sidebar: label: "Factory agents" --- -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - Every factory has a **foreman**, the agent you talk to from the tool that sends the request, such as Slack or Linear. Four other default agents each cover one part of the software development lifecycle: triage scopes the request, spec writes the plan, implement writes the code, and review checks it. Together they take a work item from the moment it reaches your factory to a pull request ready for review. ## The default agents diff --git a/src/content/docs/factories/factory-api.mdx b/src/content/docs/factories/factory-api.mdx index f2a051fa9..8e044192a 100644 --- a/src/content/docs/factories/factory-api.mdx +++ b/src/content/docs/factories/factory-api.mdx @@ -10,10 +10,6 @@ import { VARS } from '@data/vars'; The factory endpoints are part of the {VARS.WARP_PLATFORM_API}. Use them to find a factory and start work from a custom integration without managing agent details. Build them into a chat bot, script, or service for any tool Warp doesn't connect to directly. -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - ## How it works * `GET /factory` - list factories your account can access. Add `search` to filter by name or alias, case-insensitive. diff --git a/src/content/docs/factories/factory-skills.mdx b/src/content/docs/factories/factory-skills.mdx index 5135d59ff..e279b6fb7 100644 --- a/src/content/docs/factories/factory-skills.mdx +++ b/src/content/docs/factories/factory-skills.mdx @@ -7,10 +7,6 @@ sidebar: label: "Factory skills" --- -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - A skill tells an agent what to check, how to classify results, what to produce, and when to escalate. In a factory, skills are how you extend or override [default agents](/factories/factory-agents/), without editing their prompts directly. ## Skill sources in a factory diff --git a/src/content/docs/factories/how-factories-work.mdx b/src/content/docs/factories/how-factories-work.mdx index 435685dcb..eb87c381c 100644 --- a/src/content/docs/factories/how-factories-work.mdx +++ b/src/content/docs/factories/how-factories-work.mdx @@ -7,10 +7,6 @@ sidebar: label: "How factories work" --- -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - A factory is a fleet of agents wired to your software development lifecycle. It connects your repositories and tools to move requests through triage, specification, implementation, review, and verification, while people stay in control of key decisions. You talk to one agent, the **foreman**, from the tool that sends the request, such as Slack or Linear. The foreman dispatches the factory's other agents, and each one owns a part of the software development lifecycle. Deciding which repositories belong in this factory is a separate question. See [sizing a factory](/factories/#sizing-a-factory) for that guidance. diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index d36427bf6..769ac472e 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -9,10 +9,6 @@ sidebar: import { VARS } from '@data/vars'; import VideoEmbed from '@components/VideoEmbed.astro'; -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. If your team already has access, sign in to the {VARS.FACTORY_WEB_APP}. -::: - A factory is a group of agents that shares repositories and delivery policy. Its foreman accepts work from connected tools, dispatches the right agents, and returns the result to the source. diff --git a/src/content/docs/factories/integrations/azure-devops.mdx b/src/content/docs/factories/integrations/azure-devops.mdx index a61bb40c3..650839284 100644 --- a/src/content/docs/factories/integrations/azure-devops.mdx +++ b/src/content/docs/factories/integrations/azure-devops.mdx @@ -10,10 +10,6 @@ import { VARS } from '@data/vars'; Connect Azure DevOps Services to a factory so agents can work in selected repositories, open pull requests, and start runs from work item and pull request events. Warp creates a dedicated Microsoft Entra identity for each factory's Git and pull request operations. -:::note -Warp Factories is in Early Access and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - The first-class integration supports hosted Azure DevOps Services at `dev.azure.com`. It doesn't support Azure DevOps Server. To use a self-hosted Azure DevOps Server repository, [configure it as another code forge](/factories/code-forges/other-code-forges/). For standalone cloud agent environments, use the [Azure DevOps access token setup](/platform/integrations/azure-devops/). ## How identities and access work @@ -30,7 +26,7 @@ Each factory identity consists of a separate Microsoft Entra application and ser ## Requirements -* **A Warp team with Warp Factories access** - A factory belongs to a [Warp team](/knowledge-and-collaboration/teams/). +* **A Warp team** - A factory belongs to a [Warp team](/knowledge-and-collaboration/teams/). * **An Azure DevOps Services organization** - Use an organization hosted at `dev.azure.com`, with the project and repositories the factory needs. * **A connected Azure DevOps user** - Connect a user who can read the organization, project, and repositories you want to select. * **An active connection for each automation creator** - The user who creates an Azure DevOps automation must keep their own Azure DevOps OAuth connection active with the required scopes. diff --git a/src/content/docs/factories/integrations/jira.mdx b/src/content/docs/factories/integrations/jira.mdx index 01e848f2f..f965a7ec2 100644 --- a/src/content/docs/factories/integrations/jira.mdx +++ b/src/content/docs/factories/integrations/jira.mdx @@ -13,13 +13,15 @@ Connect Jira Cloud to your factory so your team can start factory work without l ## Prerequisites * **Jira Cloud** - The integration supports Jira Cloud only, not Jira Server or Data Center. -* **A Jira site admin** - Installing the Warp app on a Jira site and connecting it to a Warp workspace requires site admin permissions. +* **A Jira site admin** - Installing the Warp app on a Jira site and connecting it to a Warp workspace requires site admin permissions. If you are not a site admin, you can send the setup to one instead. * **A factory** - You need a factory in the connected workspace and permission to edit its [definition](/factories/factory-as-code/). * **The Warp agent in Jira** - The **Warp** agent must be available on your Jira site so people can assign or mention it on work items. Jira lists it among Atlassian's Rovo agents. ## Connect Jira and add an automation -1. **Install the Warp app on your Jira site and connect it to your Warp workspace.** The [Jira integration setup](/platform/integrations/jira/#setup) walks through both. Once connected, every factory in the workspace can use it. (That page's `warp-agent` label flow starts standalone cloud agent runs; factories skip the label and use an automation instead.) +1. **Install the Warp app on your Jira site and connect it to your Warp workspace.** Choose Jira during factory setup or from the workspace's **Integrations** page. If you are a Jira site admin, connect the site directly. Otherwise, choose **Someone else**, enter the Atlassian site, and email one or more site admins a setup request or copy an approval link to send yourself. Each link is valid for seven days and lets its holder install Warp for Jira and connect that site without signing in to your Warp session. Once connected, every factory in the workspace can use it. + + You can add recipients, resend or revoke an emailed link, copy or reset your own approval link, or revoke the whole request while setup is pending. The [Jira integration setup](/platform/integrations/jira/#setup) explains the direct installation steps. That page's `warp-agent` label flow starts standalone cloud agent runs; factories skip the label and use an automation instead. 2. **Connect Jira to this factory.** A workspace connection makes Jira available to your factories, but each one opts in separately: in the factory's **Settings**, connect **Jira** and select the projects that should trigger it. @@ -84,7 +86,7 @@ Warp's built-in Jira tools read Jira as the person who created the run; that per ## Troubleshooting -* **Warp is unavailable in Jira** - Confirm the Warp app is installed on the Jira Cloud site. On the app's **Configure** page, click **Connect to Warp** if the installation isn't connected to a workspace. +* **Warp is unavailable in Jira** - Confirm the Warp app is installed on the Jira Cloud site. On the app's **Configure** page, click **Connect to Warp** if the installation isn't connected to a workspace. If someone else is completing setup, confirm that their setup link is still active. * **No run starts** - Confirm an enabled `agent_session_created` automation exists, its agent is available, and its project and keyword filters match the assignment. * **The session shows no result** - Open the matching automation's run to see whether the agent is still working, waiting for input, or failed. * **A Jira update fails** - Confirm the app can access the work item's project and that the requested action or workflow transition is valid. diff --git a/src/content/docs/factories/integrations/teams.mdx b/src/content/docs/factories/integrations/teams.mdx index 7939e87aa..888f079b7 100644 --- a/src/content/docs/factories/integrations/teams.mdx +++ b/src/content/docs/factories/integrations/teams.mdx @@ -10,13 +10,6 @@ import { VARS } from '@data/vars'; Connect a factory to Microsoft Teams so your team can send work from channel conversations. Mention the Warp app in a configured standard or shared channel, and the factory replies in the same thread. -## Who does each step - -* **Warp workspace admin** - Makes Microsoft Teams available and connects installed teams to the Warp workspace. -* **Microsoft Teams admin** - Uploads and approves the Warp custom app in the Teams admin center. -* **Factory editor** - Selects the connected teams and channels for a factory and manages its automations. -* **End user** - Mentions **@Warp** to start work. - :::caution The integration supports standard and shared channels. Private channels and direct messages are not supported. ::: @@ -24,8 +17,8 @@ The integration supports standard and shared channels. Private channels and dire ## Set up Microsoft Teams 1. **Enable Microsoft Teams for the Warp workspace.** A workspace admin opens the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}. If **Microsoft Teams** doesn't appear, contact sales. -2. **Download the Warp Teams app.** On the **Microsoft Teams** integration, click **Connect**, sign in with Microsoft when prompted, then click **Download Warp app package**. The `warp-microsoft-teams-app.zip` file contains the app manifest and icons, with no executable files. -3. **Upload and approve the app.** A Microsoft Teams admin opens the [Teams admin center](https://admin.teams.microsoft.com), goes to **Teams apps** > **Manage apps**, and clicks **Upload new app**, uploads the ZIP, and approves it. Warp then appears under **Apps** > **Built for your org** in Teams. +2. **Choose who completes setup.** On the **Microsoft Teams** integration, click **Connect**. If you administer Teams, continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. While setup is pending, you can manage its recipients and links. +3. **Install the Warp app.** For direct setup, sign in with Microsoft, download the `warp-microsoft-teams-app.zip` package, and follow the upload instructions. Upload and approve the package under **Teams apps** > **Manage apps** in the [Teams admin center](https://admin.teams.microsoft.com). A delegated recipient does this from the setup link without using your Warp session. 4. **Add Warp to each team.** In Microsoft Teams, open **Apps** > **Built for your org** > **Warp**, then click **Add** for every team the factory should use. 5. **Connect the installed teams to the Warp workspace.** Back on the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}, the workspace admin selects the new teams and clicks **Enable**. If a workspace admin selects a pending team while configuring a factory, Warp performs this connection automatically. 6. **Select teams and channels for the factory.** While creating the factory, or from the factory's **Settings**, choose **Microsoft Teams**, select the connected teams, and select at least one standard channel in each team. Click **Enable** or finish factory setup. @@ -42,8 +35,6 @@ Warp creates an enabled **teams-app-mentions** automation for the teams and chan * **Start work** - Mention **@Warp** in a configured channel or thread. The factory includes supported attachments and replies in the same thread. Unsupported attachments don't block the request text. * **Continue work** - Reply in a thread that already has a factory work item. When responses to thread replies are enabled, eligible replies continue that work without another mention. -* **Use shared channels** - New root messages in shared channels still require an explicit **@Warp** mention. See the [shared-channel rules](#use-shared-channels). -* **Review results** - Follow progress and the final response in Teams. For code-change work, the factory can also open a pull request. Other workflows can return results directly in the thread. Automation-started work runs as the factory agent selected in that automation. To manage your account link, mention **@Warp** with `sign in`, `sign out`, or `help` in a channel where the app is installed. For `sign in`, follow the private link, then send your request again. `sign out` unlinks your account from every factory in that Microsoft organization. @@ -122,7 +113,7 @@ See the [factory definition syntax](/factories/factory-as-code/#integrations) fo ## Troubleshooting * **Microsoft Teams is missing in Warp** - Ask a workspace admin to confirm the integration is enabled. If it isn't available, contact sales. -* **An installed team is missing in Warp** - Confirm the app is approved, then click **Add** for that team from **Apps** > **Built for your org** in Teams. A Warp workspace admin must then select the team on the top-level **Integrations** page to connect it to the workspace. +* **An installed team is missing in Warp** - Confirm the app is approved, then click **Add** for that team from **Apps** > **Built for your org** in Teams. A Warp workspace admin must then select the team on the top-level **Integrations** page to connect it to the workspace. For delegated setup, confirm that the admin or team owner's setup link is still active. * **Warp says, "This Microsoft Teams channel isn't connected to a Warp Factory. Connect this team to a Factory, then mention this bot again."** - Ask a Warp workspace admin to connect the team on the top-level **Integrations** page, then mention **@Warp** again. * **Warp doesn't acknowledge a mention** - Confirm the team and channel are selected, mention **@Warp**, and follow any private account-linking prompt. For a shared channel, check the [shared-channel rules](#use-shared-channels). * **A channel is missing from the picker** - The picker lists standard channels only. Add a shared channel through the [factory definition](#configure-microsoft-teams-as-code). diff --git a/src/content/docs/factories/measure-and-improve/self-improvement.mdx b/src/content/docs/factories/measure-and-improve/self-improvement.mdx index 8cf6b2f18..b34af437c 100644 --- a/src/content/docs/factories/measure-and-improve/self-improvement.mdx +++ b/src/content/docs/factories/measure-and-improve/self-improvement.mdx @@ -9,7 +9,9 @@ sidebar: {/* VISUAL: The Self-improvement pull request list, or a Benchmarks suite run -- this section is text-only today. */} -Turn on **Self-improvement** for each Scorer whose failures you want investigated automatically. A failure is a score below the Scorer's pass threshold. The scheduled check starts a Self-improvement run after an agent has 25 unreviewed failures, or when its oldest unreviewed failure is seven days old. It groups the failures for each agent into a follow-up run that proposes a fix. +Turn on **Self-improvement** for each Scorer whose failures you want investigated automatically. A failure is a score below the Scorer's pass threshold. By default, the scheduled check starts a Self-improvement run after an agent has 25 distinct unreviewed failures, or when its oldest unreviewed failure is seven days old. It groups the failures for each agent into a follow-up run that proposes a fix. + +For a GitHub-backed factory, set `selfImprovement.failedRunThreshold` in `factory.yaml` to change the scheduled threshold to any value from 1 through 50. You can also choose who Warp requests for review with `reviewerType`: factory team admins (the default), any team member, a custom list of team members, or no requested reviewer. A custom pool also requires `reviewerEmails`. See [`selfImprovement` in the factory definition reference](/factories/factory-as-code/#selfimprovement). To run the check without waiting for the scheduled threshold, click **Run now** on the factory dashboard's **Self-improvement** page. An ad hoc run can include an agent with one unreviewed failure. You cannot choose which agents or failures it processes. diff --git a/src/content/docs/factories/quickstart.mdx b/src/content/docs/factories/quickstart.mdx index a26486473..89e7df863 100644 --- a/src/content/docs/factories/quickstart.mdx +++ b/src/content/docs/factories/quickstart.mdx @@ -8,17 +8,13 @@ sidebar: --- import { VARS } from '@data/vars'; -:::note -Warp Factories is in **Early Access** and available to a limited set of teams. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. -::: - -Create a factory and take one small work item from prompt to pull request in about 10 minutes. This quickstart is for teams that already have Warp Factories access and know which repositories they want the factory to use. - +Create a factory and take one small work item from prompt to pull request in about 10 minutes. ## Prerequisites -* **Warp Factories access** - [Request Early Access](https://www.warp.dev/factories/request-access) for your team. -* **A Warp team with credits** - The team's [credits](/support-and-community/plans-and-billing/platform-credits/) are consumed by factory agents. +* **A Warp account and team** - [Get started with Warp](https://www.warp.dev/get-started), then join or create the team that will own the factory. +* **Permission to create factories** - You must be a team admin or have editor permission for Warp Factories. Other team members can run and view factories but cannot create or configure them. +* **Available team usage** - The factory's agents consume the team's [credits](/support-and-community/plans-and-billing/platform-credits/). * **Repository access** - Authorize GitHub, GitLab, or Azure DevOps during setup. Restricted organizations need owner approval. Azure DevOps also requires [one-time administrator approval](/factories/integrations/azure-devops/#requirements). ## Set up your factory @@ -29,7 +25,6 @@ _About 5 minutes_ For GitHub and GitLab repositories, an agent connected to [Factory MCP](/factories/factory-mcp/#set-up-with-your-coding-agent) can run this whole setup. Use the web setup wizard for Azure DevOps. If the wizard is still open when the agent finishes, refresh the page to see the new factory. ::: - 1. Sign in to the {VARS.FACTORY_WEB_APP}. Next to **Factories**, click **+**.
@@ -85,7 +80,6 @@ Send work from Slack or an issue tracker. If you skipped integrations, start a r repo's lint check, and open a pull request. ``` - 2. The foreman dispatches the agents needed for the request and posts progress where it started. Follow the foreman and child runs on the factory's [Runs page](/factories/factory-dashboard/#inspect-runs). Requests for input also appear in your [inbox](/factories/factory-inbox/). If you connected Slack, you can follow along there instead: diff --git a/src/content/docs/factories/troubleshooting.mdx b/src/content/docs/factories/troubleshooting.mdx index a021a649c..bcf9c5934 100644 --- a/src/content/docs/factories/troubleshooting.mdx +++ b/src/content/docs/factories/troubleshooting.mdx @@ -12,11 +12,11 @@ Fix the problems teams hit most often when setting up a factory and running thei ## Setting up a factory -### You don't have access to Warp Factories +### You can't create or configure a factory -**Cause:** Warp Factories is in Early Access and enabled per team. +**Cause:** Creating and configuring factories requires a team admin or editor permission for Warp Factories. Other team members can run and view factories but cannot change their configuration. -**Fix:** [Request access](https://www.warp.dev/factories/request-access) for your team. If a teammate already has it, ask a team admin to confirm you're on that team. +**Fix:** Ask a team admin to grant you editor permission, or ask a team admin or factory editor to create the factory. ### A repository doesn't appear in the picker diff --git a/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx b/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx index 3b6b9128b..ed413cc1f 100644 --- a/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx +++ b/src/content/docs/guides/agent-workflows/build-a-self-improving-agent.mdx @@ -24,7 +24,7 @@ The outer loop proposes improvements; it doesn't apply them silently. Every chan ## Prerequisites * A working inner loop with at least one agent running ([set up your software factory](/guides/agent-workflows/set-up-a-software-factory)) -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account ([get started with Warp](https://www.warp.dev/get-started)) * A cloud environment with access to your repository ([create one](/platform/environments)) ## Why principles beat rules diff --git a/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx b/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx index af83db49c..3c3bbc75a 100644 --- a/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx +++ b/src/content/docs/guides/agent-workflows/build-a-triage-agent.mdx @@ -15,7 +15,7 @@ Learn how to use the {VARS.WARP_AUTOMATION_PLATFORM} to build a triage agent tha ## Prerequisites -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account ([get started with Warp](https://www.warp.dev/get-started)) * A GitHub repository with Issues enabled * A cloud environment with access to your repository ([create one](/platform/environments/configuring-environments/#create-an-environment-with-guided-setup)) * A Warp API key added to your CI secrets as `WARP_API_KEY` ([create one](/agents/cli/oz-cli/api-keys/#from-the-web-app-recommended)) diff --git a/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx b/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx index 511fe9544..226424fa9 100644 --- a/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx +++ b/src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx @@ -13,12 +13,12 @@ tags: --- import { VARS } from '@data/vars'; -The GitHub Actions approach in [Set up your software factory](/guides/agent-workflows/set-up-a-software-factory) gets the four-agent loop working. This guide covers the {VARS.WARP_AUTOMATION_PLATFORM}-native production setup for teams running the factory at scale: cloud environments, secrets and permissions, triggers, and observability. To run the same loop as a managed product instead, see [Warp Factories](/factories/). +The GitHub Actions approach in [Set up your software factory](/guides/agent-workflows/set-up-a-software-factory) gets the four-agent loop working. Use the {VARS.WARP_AUTOMATION_PLATFORM}-native production setup to add cloud environments, permissions, triggers, and observability. To run the same loop as a managed product instead, see [Warp Factories](/factories/). ## Prerequisites * A working software factory loop ([set one up](/guides/agent-workflows/set-up-a-software-factory)) -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account ([get started with Warp](https://www.warp.dev/get-started)) ## Why cloud agents, not cloud computers diff --git a/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx b/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx index f0983809b..27a5980a8 100644 --- a/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx +++ b/src/content/docs/guides/agent-workflows/write-product-and-tech-specs-with-agents.mdx @@ -18,7 +18,7 @@ Specs give implementation agents the context they need to make good decisions, a ## Prerequisites -* A Warp account ([sign up at warp.dev](https://www.warp.dev)) +* A Warp account ([get started with Warp](https://www.warp.dev/get-started)) * A triaged issue labeled `ready-to-spec` or equivalent ([set up triaging](/guides/agent-workflows/build-a-triage-agent)) * `common-skills` installed globally from [`warpdotdev/common-skills`](https://github.com/warpdotdev/common-skills): diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 5ce13adc8..e3695b83f 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -31,7 +31,7 @@ The {VARS.WARP_AUTOMATION_PLATFORM} runs cloud agents from triggers, schedules, ## Warp Factories -Warp Factories is available in Early Access. A factory turns incoming engineering work into a repeatable, multi-stage workflow with specialized agents, review points, and measurable outcomes. +A factory turns incoming engineering work into a repeatable, multi-stage workflow with specialized agents, review points, and measurable outcomes. * [Warp Factories overview](/factories/) - Learn how a factory receives, routes, and tracks work. * [Factory quickstart](/factories/quickstart/) - Create a factory and send it its first work item. diff --git a/src/content/docs/platform/overview.mdx b/src/content/docs/platform/overview.mdx index b3a590356..75a83bb2d 100644 --- a/src/content/docs/platform/overview.mdx +++ b/src/content/docs/platform/overview.mdx @@ -66,7 +66,7 @@ Runs pick up your team's shared setup no matter what triggered them: [MCP server ## Warp Factories -[Warp Factories](/factories/) builds on these pieces to run persistent, multi-agent development workflows: specialized cloud agents move each work item through triage, specification, implementation, and review. It's in Early Access. [Request access](https://www.warp.dev/factories/request-access) to use it with your team. +[Warp Factories](/factories/) builds on these pieces to run persistent, multi-agent development workflows: specialized cloud agents move each work item through triage, specification, implementation, and review. ## Where to go next diff --git a/src/sidebar.ts b/src/sidebar.ts index 68b781cc3..e3832b2e0 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -382,13 +382,11 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ ], }, { - // Warp Factories documentation for Early Access. // Starlight has no built-in factory glyph, so use its settings icon. id: 'factories', label: 'Factories', link: '/factories/', icon: 'setting', - badge: { text: 'Early Access', variant: 'note' }, // Group labels are noun phrases naming a subject area, not imperative // verbs. Every other tab does this -- 'Agent configuration', // 'Triggers & integrations', 'Plans and billing', 'Team management' -- From 3503302fad94d4703e2fbbdb594ee9d677d74515 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 17:06:12 +0000 Subject: [PATCH 03/16] docs: clarify factory governance roles Document self-improvement reviewer selection and the Factory User, Editor, and Admin permission boundaries. Co-Authored-By: Oz --- src/content/docs/factories/infrastructure-and-security.mdx | 4 +++- .../docs/factories/measure-and-improve/self-improvement.mdx | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/src/content/docs/factories/infrastructure-and-security.mdx b/src/content/docs/factories/infrastructure-and-security.mdx index 64660a837..f71236ce6 100644 --- a/src/content/docs/factories/infrastructure-and-security.mdx +++ b/src/content/docs/factories/infrastructure-and-security.mdx @@ -115,7 +115,9 @@ Scope each credential to the resources and actions its agent needs. Warp redacts ## Governance and metering -Factories use your existing [team roles](/enterprise/team-management/roles-and-permissions/): Team Owners and Admins control factory definitions, runners, secrets, and provider configuration. Warp Factories doesn't add a factory-specific approval role, so who reviews specifications and who approves merges stays a workflow and repository policy decision. Treat factory-definition changes as operational code: review them like any other change, and keep merge access with the people responsible for shipping. +Factory access combines [team and workspace permissions](/enterprise/team-management/roles-and-permissions/) with three factory roles: User, Editor, and Admin. Users view and run a factory and propose definition changes. Editors configure its definition, agents, repositories, automations, and attached integrations, secrets, MCP servers, and runners. Admins also manage members, delete the factory, and force-merge a blocked definition change. Team and workspace admins and owners always have the Admin role. + +Creating or editing shared runners and connecting team-wide integrations and providers remain team or workspace permissions. Factory roles don't determine who reviews specifications or approves pull request merges; those stay in workflow and repository policy. Warp meters hosted compute, Warp-provided inference, and platform services. Managed self-hosted execution moves compute costs to your own infrastructure, and customer-supplied inference bills model usage through your provider account. Platform services consume credits regardless of these choices. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for details. diff --git a/src/content/docs/factories/measure-and-improve/self-improvement.mdx b/src/content/docs/factories/measure-and-improve/self-improvement.mdx index b34af437c..79285a2ee 100644 --- a/src/content/docs/factories/measure-and-improve/self-improvement.mdx +++ b/src/content/docs/factories/measure-and-improve/self-improvement.mdx @@ -11,7 +11,7 @@ sidebar: Turn on **Self-improvement** for each Scorer whose failures you want investigated automatically. A failure is a score below the Scorer's pass threshold. By default, the scheduled check starts a Self-improvement run after an agent has 25 distinct unreviewed failures, or when its oldest unreviewed failure is seven days old. It groups the failures for each agent into a follow-up run that proposes a fix. -For a GitHub-backed factory, set `selfImprovement.failedRunThreshold` in `factory.yaml` to change the scheduled threshold to any value from 1 through 50. You can also choose who Warp requests for review with `reviewerType`: factory team admins (the default), any team member, a custom list of team members, or no requested reviewer. A custom pool also requires `reviewerEmails`. See [`selfImprovement` in the factory definition reference](/factories/factory-as-code/#selfimprovement). +For a GitHub-backed factory, set `selfImprovement.failedRunThreshold` in `factory.yaml` to change the scheduled threshold to any value from 1 through 50. You can also choose the reviewer pool with `reviewerType`. Warp randomly requests one eligible reviewer from team admins and owners (the default), any team member, or a custom list of team members. The `none` value requests no reviewer. A custom pool also requires `reviewerEmails`. See [`selfImprovement` in the factory definition reference](/factories/factory-as-code/#selfimprovement). To run the check without waiting for the scheduled threshold, click **Run now** on the factory dashboard's **Self-improvement** page. An ad hoc run can include an agent with one unreviewed failure. You cannot choose which agents or failures it processes. From ac46131ae240eebd20cdfdd2aa0a46dd5b4ead22 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 18:07:35 +0000 Subject: [PATCH 04/16] docs: add two-path Factories landing CTA Co-Authored-By: Oz --- src/content/docs/factories/index.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index 4a5302f69..1e5a44af0 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -7,10 +7,14 @@ sidebar: label: "Overview" --- import { VARS } from '@data/vars'; +import { LinkButton } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; :::note -Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, get started with Warp Factories. If your team already has access, sign in to the {VARS.FACTORY_WEB_APP}. +Warp Factories is in **Early Access** and available to a limited set of teams. If your team is new to Warp Factories, tell us about your team to get started. If your team already has access, open the {VARS.FACTORY_WEB_APP}. + +Get started with Warp Factories +Open the {VARS.FACTORY_WEB_APP} ::: A factory is a group of agents that shares repositories and delivery policy. Its foreman accepts work from connected tools, dispatches the right agents, and returns the result to the source. From ee8dae82359b735363041d73710e290c7917613d Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 18:57:00 +0000 Subject: [PATCH 05/16] docs: use link cards for Factories access paths Co-Authored-By: Oz --- src/content/docs/factories/index.mdx | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index 000d424cf..144e98548 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -7,13 +7,23 @@ sidebar: label: "Overview" --- import { VARS } from '@data/vars'; -import { LinkButton } from '@astrojs/starlight/components'; +import { CardGrid, LinkCard } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; A factory is a group of agents that shares repositories and delivery policy. Its foreman accepts work from connected tools, dispatches the right agents, and returns the result to the source. -Get started with Warp Factories -Open the {VARS.FACTORY_WEB_APP} + + + + From 1553149aa04d41c3a9a4e0b6d35afc37be0b72ef Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:04:58 +0000 Subject: [PATCH 06/16] docs: clarify Factories setup permissions Co-Authored-By: Oz --- src/content/docs/factories/integrations/teams.mdx | 2 +- src/content/docs/factories/quickstart.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/factories/integrations/teams.mdx b/src/content/docs/factories/integrations/teams.mdx index 888f079b7..7db2882be 100644 --- a/src/content/docs/factories/integrations/teams.mdx +++ b/src/content/docs/factories/integrations/teams.mdx @@ -18,7 +18,7 @@ The integration supports standard and shared channels. Private channels and dire 1. **Enable Microsoft Teams for the Warp workspace.** A workspace admin opens the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}. If **Microsoft Teams** doesn't appear, contact sales. 2. **Choose who completes setup.** On the **Microsoft Teams** integration, click **Connect**. If you administer Teams, continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. While setup is pending, you can manage its recipients and links. -3. **Install the Warp app.** For direct setup, sign in with Microsoft, download the `warp-microsoft-teams-app.zip` package, and follow the upload instructions. Upload and approve the package under **Teams apps** > **Manage apps** in the [Teams admin center](https://admin.teams.microsoft.com). A delegated recipient does this from the setup link without using your Warp session. +3. **Install the Warp app.** For direct setup, sign in with Microsoft and click **Download Warp app package**. The `warp-microsoft-teams-app.zip` package contains the app manifest and icons, with no executable files. In the [Teams admin center](https://admin.teams.microsoft.com), go to **Teams apps** > **Manage apps**, click **Upload new app**, upload and approve the package, and confirm Warp appears under **Apps** > **Built for your org** in Teams. A delegated recipient follows the same steps from the setup link without using your Warp session. 4. **Add Warp to each team.** In Microsoft Teams, open **Apps** > **Built for your org** > **Warp**, then click **Add** for every team the factory should use. 5. **Connect the installed teams to the Warp workspace.** Back on the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}, the workspace admin selects the new teams and clicks **Enable**. If a workspace admin selects a pending team while configuring a factory, Warp performs this connection automatically. 6. **Select teams and channels for the factory.** While creating the factory, or from the factory's **Settings**, choose **Microsoft Teams**, select the connected teams, and select at least one standard channel in each team. Click **Enable** or finish factory setup. diff --git a/src/content/docs/factories/quickstart.mdx b/src/content/docs/factories/quickstart.mdx index d4bc96f70..98539182a 100644 --- a/src/content/docs/factories/quickstart.mdx +++ b/src/content/docs/factories/quickstart.mdx @@ -13,7 +13,7 @@ Create a factory and take one small work item from prompt to pull request in abo ## Prerequisites * **A Warp account and team** - Get started with Warp, then join or create the team that will own the factory. -* **Permission to create factories** - You must be a team admin or have editor permission for Warp Factories. Other team members can run and view factories but cannot create or configure them. +* **Permission to create factories** - Team and workspace admins, plus members whose team-level Warp Factories role is Editor, can create a factory. Members whose team-level role is User can view and run factories but cannot create one. See [factory roles and team permissions](/factories/infrastructure-and-security/#governance-and-metering). * **Available team usage** - The factory's agents consume the team's [credits](/support-and-community/plans-and-billing/platform-credits/). * **Repository access** - Authorize GitHub, GitLab, or Azure DevOps during setup. Restricted organizations need owner approval. Azure DevOps also requires [one-time administrator approval](/factories/integrations/azure-devops/#requirements). From 9d3fcab412f7e88c122dea3cc088c12961ffbe07 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:05:20 +0000 Subject: [PATCH 07/16] docs: clarify Factories CTA outcomes Co-Authored-By: Oz --- src/content/docs/factories/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index 144e98548..272c8f9f6 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -16,12 +16,12 @@ A factory is a group of agents that shares repositories and delivery policy. Its From 7ad7d8eeaefbf376d0efa826f333e30f8ab01909 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:27:07 +0000 Subject: [PATCH 08/16] docs: resolve Factories launch review findings Co-Authored-By: Oz --- src/content/docs/factories/index.mdx | 2 +- .../factories/infrastructure-and-security.mdx | 29 +++++++------------ .../docs/factories/integrations/jira.mdx | 12 ++++---- .../docs/factories/integrations/teams.mdx | 11 +++---- .../measure-and-improve/self-improvement.mdx | 2 +- .../docs/factories/troubleshooting.mdx | 4 +-- 6 files changed, 28 insertions(+), 32 deletions(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index 272c8f9f6..d98a630c0 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -16,7 +16,7 @@ A factory is a group of agents that shares repositories and delivery policy. Its D["Warp-managed storage"] ``` -Self-hosting moves only the execution plane: with a managed self-hosted worker, repository checkouts, command execution, and the sandbox filesystem stay on machines you control, but content that enters prompts, results, transcripts, attachments, artifacts, or telemetry still flows through Warp and the providers you configure. See [deployment patterns](/factories/deployment-patterns/) and [execution security](/platform/execution-security/) for the broader data model. - -The diagram below maps those boundaries for self-hosted execution; factory runs follow the same data model. See the [data security and boundaries](/platform/architecture/#data-security-and-boundaries) reference for a description of each data class. +With managed self-hosting, repository checkouts, commands, and sandbox files stay on machines you control. Prompts, results, transcripts, attachments, artifacts, and telemetry still flow through Warp and configured providers. See [deployment patterns](/factories/deployment-patterns/), [execution security](/platform/execution-security/), and the [data security and boundaries](/platform/architecture/#data-security-and-boundaries) reference for details. ![Self-hosted data security and boundaries diagram showing what stays in customer infrastructure, what Warp retains, and what transits Warp to model providers](../../../assets/agent-platform/data-security-boundaries.png) ## Runners -A runner defines the compute a factory's agents work on: the operating system and architecture, the sandbox image, and the instance shape (vCPUs and memory). The workspace itself — repositories, setup commands, and secrets — comes from the factory's [definition](/factories/factory-as-code/). See the [runner reference](/factories/runners/) for the available compute options. - -Declare runners as `runners/*.yaml` files. Every agent inherits `agentDefaults.runner`, and an agent or automation can override it. The execution host determines how the runner's compute settings are used: +A runner selects the operating system, architecture, sandbox image, and vCPU and memory shape. The factory's [definition](/factories/factory-as-code/) supplies repositories, setup commands, and secrets. Define runners in `runners/*.yaml`; `agentDefaults.runner` sets the default, and agents and automations can override it. The execution host determines how each setting is used: | Setting | Warp-hosted | Direct | Kubernetes | Docker | | --- | --- | --- | --- | --- | @@ -48,8 +44,6 @@ Declare runners as `runners/*.yaml` files. Every agent inherits `agentDefaults.r Self-hosted runner settings do not provision worker capacity. Worker configuration controls host resources, registry authentication, volumes, node placement, and other backend policy. -See [cloud agent runner compute options](/factories/runners/) and [factory runner syntax](/factories/factory-as-code/#runnersnameyaml). - ## Choose an execution host A factory runs its work on one of two execution hosts: Warp-hosted compute or a worker in the [managed self-hosting architecture](/factories/self-hosting/#managed-architecture). @@ -115,21 +109,20 @@ Scope each credential to the resources and actions its agent needs. Warp redacts ## Governance and metering -Factory access combines [team and workspace permissions](/enterprise/team-management/roles-and-permissions/) with three factory roles: User, Editor, and Admin. Users view and run a factory and propose definition changes. Editors configure its definition, agents, repositories, automations, and attached integrations, secrets, MCP servers, and runners. Admins also manage members, delete the factory, and force-merge a blocked definition change. Team and workspace admins and owners always have the Admin role. +Factory creation uses the team-level Warp Factories role. Team and workspace admins and members with the team-level Editor role can create factories. + +Three roles govern an existing factory: + +* **User** - View and run the factory, and propose definition changes. +* **Editor** - Configure the factory, its agents, repositories, automations, integrations, secrets, MCP servers, and runners. +* **Admin** - Manage members, delete the factory, and force-merge a blocked definition change. + +Team and workspace admins and owners always have the Admin role. Admins for a factory manage its roles; team and workspace admins manage the team-level role. Creating or editing shared runners and connecting team-wide integrations and providers remain team or workspace permissions. Factory roles don't determine who reviews specifications or approves pull request merges; those stay in workflow and repository policy. Warp meters hosted compute, Warp-provided inference, and platform services. Managed self-hosted execution moves compute costs to your own infrastructure, and customer-supplied inference bills model usage through your provider account. Platform services consume credits regardless of these choices. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for details. -## Deployment checklist - -1. **Classify the workload** - Identify the repositories, data, internal services, and regulated systems the factory can reach. -2. **Choose execution** - Decide where checkout, commands, and the sandbox filesystem must run. -3. **Configure the factory and its runners** - Set the repositories, setup commands, secrets, and compatible runners in the factory's definition. -4. **Choose inference** - Select provider routing. -5. **Scope credentials** - Set each agent's secret allowlist, harness authentication, and repository identity. -6. **Set review gates** - Decide where humans review specifications and pull requests, and enforce those gates in workflow and repository policy. -7. **Validate operations** - Test network egress, isolation, rotation, redaction, capacity, observability, and metering before increasing volume. ## Related pages diff --git a/src/content/docs/factories/integrations/jira.mdx b/src/content/docs/factories/integrations/jira.mdx index f965a7ec2..9e6898b57 100644 --- a/src/content/docs/factories/integrations/jira.mdx +++ b/src/content/docs/factories/integrations/jira.mdx @@ -19,13 +19,15 @@ Connect Jira Cloud to your factory so your team can start factory work without l ## Connect Jira and add an automation -1. **Install the Warp app on your Jira site and connect it to your Warp workspace.** Choose Jira during factory setup or from the workspace's **Integrations** page. If you are a Jira site admin, connect the site directly. Otherwise, choose **Someone else**, enter the Atlassian site, and email one or more site admins a setup request or copy an approval link to send yourself. Each link is valid for seven days and lets its holder install Warp for Jira and connect that site without signing in to your Warp session. Once connected, every factory in the workspace can use it. +1. **Choose who connects Jira.** Open Jira during factory setup or from the workspace's **Integrations** page. If you are a Jira site admin, continue directly. Otherwise, choose **Someone else**. - You can add recipients, resend or revoke an emailed link, copy or reset your own approval link, or revoke the whole request while setup is pending. The [Jira integration setup](/platform/integrations/jira/#setup) explains the direct installation steps. That page's `warp-agent` label flow starts standalone cloud agent runs; factories skip the label and use an automation instead. +2. **Send the setup to a Jira site admin.** Enter the Atlassian site, then email one or more site admins or copy an approval link to send to a site admin yourself. Links expire seven days after the request is created. While setup is pending, you can add recipients, resend or revoke an emailed link, copy or reset your own link, or revoke the request. -2. **Connect Jira to this factory.** A workspace connection makes Jira available to your factories, but each one opts in separately: in the factory's **Settings**, connect **Jira** and select the projects that should trigger it. +3. **Install Warp for Jira and connect the site.** The site admin completes these steps in the direct setup flow or from the approval link, without using your Warp session. Once connected, every factory in the workspace can use Jira. The [Jira integration setup](/platform/integrations/jira/#setup) explains the direct installation steps. That page's `warp-agent` label flow starts standalone cloud agent runs; factories skip the label and use an automation instead. -3. **Point an automation at Jira.** In the factory's dashboard, open **Automations** and add a trigger for **Jira** > **Agent session created**. Use **Projects** and, optionally, **Keywords** to scope which sessions start a run, and choose the agent that handles them. +4. **Connect Jira to this factory.** A workspace connection makes Jira available to your factories, but each one opts in separately: in the factory's **Settings**, connect **Jira** and select the projects that should trigger it. + +5. **Point an automation at Jira.** In the factory's dashboard, open **Automations** and add a trigger for **Jira** > **Agent session created**. Use **Projects** and, optionally, **Keywords** to scope which sessions start a run, and choose the agent that handles them. If you picked Jira projects when you created the factory, that automation already exists. Edit it rather than adding a second one. @@ -48,7 +50,7 @@ Connect Jira Cloud to your factory so your team can start factory work without l With this automation, the agent named `foreman` handles sessions for work items in the `ENG` project whose assignment text contains `investigate` or `fix`. Commit and push the files to apply them; see [definitions as code](/factories/factory-as-code/) for the full syntax. -4. **Test it.** Assign or mention **Warp** on a work item and include an instruction. Jira starts an agent session, and the run appears under the matching automation in your factory. +6. **Test it.** Assign or mention **Warp** on a work item and include an instruction. Jira starts an agent session, and the run appears under the matching automation in your factory. {/* VISUAL: A Jira work item assigned to Warp, showing the resulting agent session. */} diff --git a/src/content/docs/factories/integrations/teams.mdx b/src/content/docs/factories/integrations/teams.mdx index 7db2882be..5473b16cd 100644 --- a/src/content/docs/factories/integrations/teams.mdx +++ b/src/content/docs/factories/integrations/teams.mdx @@ -17,11 +17,12 @@ The integration supports standard and shared channels. Private channels and dire ## Set up Microsoft Teams 1. **Enable Microsoft Teams for the Warp workspace.** A workspace admin opens the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}. If **Microsoft Teams** doesn't appear, contact sales. -2. **Choose who completes setup.** On the **Microsoft Teams** integration, click **Connect**. If you administer Teams, continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. While setup is pending, you can manage its recipients and links. -3. **Install the Warp app.** For direct setup, sign in with Microsoft and click **Download Warp app package**. The `warp-microsoft-teams-app.zip` package contains the app manifest and icons, with no executable files. In the [Teams admin center](https://admin.teams.microsoft.com), go to **Teams apps** > **Manage apps**, click **Upload new app**, upload and approve the package, and confirm Warp appears under **Apps** > **Built for your org** in Teams. A delegated recipient follows the same steps from the setup link without using your Warp session. -4. **Add Warp to each team.** In Microsoft Teams, open **Apps** > **Built for your org** > **Warp**, then click **Add** for every team the factory should use. -5. **Connect the installed teams to the Warp workspace.** Back on the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}, the workspace admin selects the new teams and clicks **Enable**. If a workspace admin selects a pending team while configuring a factory, Warp performs this connection automatically. -6. **Select teams and channels for the factory.** While creating the factory, or from the factory's **Settings**, choose **Microsoft Teams**, select the connected teams, and select at least one standard channel in each team. Click **Enable** or finish factory setup. +2. **Choose who completes setup.** A workspace admin starts the connection. If that person is also a Teams admin or team owner, they can continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. +3. **Download the Warp app package.** The person completing setup signs in with Microsoft and clicks **Download Warp app package**. The `warp-microsoft-teams-app.zip` package contains the app manifest and icons, with no executable files. A delegated recipient does this from the setup link without using your Warp session. +4. **Upload and approve the app.** A Teams admin opens the [Teams admin center](https://admin.teams.microsoft.com), goes to **Teams apps** > **Manage apps**, clicks **Upload new app**, and uploads and approves the package. +5. **Add Warp to each team.** In Microsoft Teams, you or a Teams admin opens **Apps** > **Built for your org** > **Warp**, then clicks **Add** for every team the factory should use. +6. **Connect the installed team to the Warp workspace.** Return to the setup flow, select the team, and connect it. A delegated recipient finishes from the approval link. For direct setup, the workspace admin selects the team on the top-level **Integrations** page and clicks **Enable**. +7. **Select teams and channels for the factory.** While creating the factory, or from the factory's **Settings**, choose **Microsoft Teams**, select the connected teams, and select at least one standard channel in each team. Click **Enable** or finish factory setup. Warp creates an enabled **teams-app-mentions** automation for the teams and channels selected in the last step. diff --git a/src/content/docs/factories/measure-and-improve/self-improvement.mdx b/src/content/docs/factories/measure-and-improve/self-improvement.mdx index 79285a2ee..532f84a13 100644 --- a/src/content/docs/factories/measure-and-improve/self-improvement.mdx +++ b/src/content/docs/factories/measure-and-improve/self-improvement.mdx @@ -11,7 +11,7 @@ sidebar: Turn on **Self-improvement** for each Scorer whose failures you want investigated automatically. A failure is a score below the Scorer's pass threshold. By default, the scheduled check starts a Self-improvement run after an agent has 25 distinct unreviewed failures, or when its oldest unreviewed failure is seven days old. It groups the failures for each agent into a follow-up run that proposes a fix. -For a GitHub-backed factory, set `selfImprovement.failedRunThreshold` in `factory.yaml` to change the scheduled threshold to any value from 1 through 50. You can also choose the reviewer pool with `reviewerType`. Warp randomly requests one eligible reviewer from team admins and owners (the default), any team member, or a custom list of team members. The `none` value requests no reviewer. A custom pool also requires `reviewerEmails`. See [`selfImprovement` in the factory definition reference](/factories/factory-as-code/#selfimprovement). +For a GitHub-backed factory, set `selfImprovement.failedRunThreshold` in `factory.yaml` to change the scheduled threshold to any value from 1 through 50. The `reviewerType` values are `admins` (the default, team admins and owners), `team` (any team member), `none`, and `custom` (members listed in `reviewerEmails`). Warp randomly requests one eligible reviewer unless you use `none`. See [`selfImprovement` in the factory definition reference](/factories/factory-as-code/#selfimprovement). To run the check without waiting for the scheduled threshold, click **Run now** on the factory dashboard's **Self-improvement** page. An ad hoc run can include an agent with one unreviewed failure. You cannot choose which agents or failures it processes. diff --git a/src/content/docs/factories/troubleshooting.mdx b/src/content/docs/factories/troubleshooting.mdx index bcf9c5934..075d197a6 100644 --- a/src/content/docs/factories/troubleshooting.mdx +++ b/src/content/docs/factories/troubleshooting.mdx @@ -14,9 +14,9 @@ Fix the problems teams hit most often when setting up a factory and running thei ### You can't create or configure a factory -**Cause:** Creating and configuring factories requires a team admin or editor permission for Warp Factories. Other team members can run and view factories but cannot change their configuration. +**Cause:** Creating a factory requires a team or workspace admin role, or the team-level Warp Factories Editor role. Configuring an existing factory requires its Editor or Admin role. -**Fix:** Ask a team admin to grant you editor permission, or ask a team admin or factory editor to create the factory. +**Fix:** Ask a team or workspace admin to set your team-level Warp Factories role to Editor. To configure an existing factory, ask an Admin for that factory to set your role to Editor. See [factory roles and team permissions](/factories/infrastructure-and-security/#governance-and-metering). ### A repository doesn't appear in the picker From bd7f5ae2536942a44514b74c84498276b0bcbb76 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:38:32 +0000 Subject: [PATCH 09/16] docs: address factories launch review Restore concise deployment safeguards, separate team and factory role guidance, and clarify delegated Jira and Microsoft Teams setup responsibilities.\n\nCo-Authored-By: Oz --- .../factories/infrastructure-and-security.mdx | 26 ++++++++++++------- .../docs/factories/integrations/jira.mdx | 8 ++++-- .../docs/factories/integrations/teams.mdx | 12 +++++++-- src/content/docs/factories/quickstart.mdx | 2 +- .../docs/factories/troubleshooting.mdx | 2 +- 5 files changed, 34 insertions(+), 16 deletions(-) diff --git a/src/content/docs/factories/infrastructure-and-security.mdx b/src/content/docs/factories/infrastructure-and-security.mdx index 71b82cdb9..004a35030 100644 --- a/src/content/docs/factories/infrastructure-and-security.mdx +++ b/src/content/docs/factories/infrastructure-and-security.mdx @@ -42,7 +42,7 @@ A runner selects the operating system, architecture, sandbox image, and vCPU and | `platform.linux.registryCredentialSecretName` | Warp-managed private-registry credential | Ignored | Ignored; use `imagePullSecrets` | Ignored; configure registry credentials on the worker, such as in its Docker config | | `instanceShape` | Sandbox size, subject to plan limits; omitted uses the workspace default | Ignored; the task uses host resources | Task-container requests and limits; overrides matching `pod_template` resources; omitted keeps template or cluster defaults | Task-container limits; omitted adds no limits | -Self-hosted runner settings do not provision worker capacity. Worker configuration controls host resources, registry authentication, volumes, node placement, and other backend policy. +Self-hosted runner settings don't provision capacity. Worker configuration controls resources, registry authentication, volumes, placement, and backend policy. See [runner compute options](/factories/runners/) for available configurations. ## Choose an execution host @@ -68,7 +68,7 @@ Unmanaged self-hosted agents and other CLI agents can't serve as a factory's exe ### Managed self-hosting structures -Factories use managed self-hosting, so Warp still orchestrates their runs. The worker backend sets isolation and scheduling on your infrastructure: +The worker backend sets isolation and scheduling on your infrastructure: | Structure | How factory runs execute | What your team operates | Use it when | | --- | --- | --- | --- | @@ -107,28 +107,34 @@ A factory handles four kinds of credentials, each with its own boundary: Scope each credential to the resources and actions its agent needs. Warp redacts known secret values at output boundaries, but redaction is a backstop, not a substitute for narrow external permissions and rotation. See [cloud agent secrets](/platform/secrets/), [harness authentication](/platform/harnesses/authentication/), [secret redaction](/support-and-community/privacy-and-security/secret-redaction/), and [team identity](/platform/team-access-billing-and-identity/) for the underlying controls. -## Governance and metering +## Factory roles and permissions -Factory creation uses the team-level Warp Factories role. Team and workspace admins and members with the team-level Editor role can create factories. +Factory creation uses the team-level Warp Factories role. Team and workspace admins and team-level Editors can create factories. Three roles govern an existing factory: * **User** - View and run the factory, and propose definition changes. -* **Editor** - Configure the factory, its agents, repositories, automations, integrations, secrets, MCP servers, and runners. +* **Editor** - Edit the factory definition, configure its agents, repositories, and automations, attach existing integrations, secrets, and MCP servers, and select existing runners. * **Admin** - Manage members, delete the factory, and force-merge a blocked definition change. Team and workspace admins and owners always have the Admin role. Admins for a factory manage its roles; team and workspace admins manage the team-level role. -Creating or editing shared runners and connecting team-wide integrations and providers remain team or workspace permissions. Factory roles don't determine who reviews specifications or approves pull request merges; those stay in workflow and repository policy. +Managing shared runners and connecting team-wide integrations and providers require team or workspace permission. Factory roles don't control specification or pull request review. Treat factory definition changes as operational code, and protect merges through repository settings. -Warp meters hosted compute, Warp-provided inference, and platform services. Managed self-hosted execution moves compute costs to your own infrastructure, and customer-supplied inference bills model usage through your provider account. Platform services consume credits regardless of these choices. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for details. +## Metering +Warp meters hosted compute, Warp-provided inference, and platform services. Self-hosting moves compute costs to your infrastructure; customer-supplied inference bills your provider account. Platform services still consume credits. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for details. + +## Deployment checklist + +1. **Classify access** - Inventory repositories, data, and services. +2. **Set boundaries** - Choose execution and inference hosts. +3. **Scope credentials** - Configure allowlists, harness authentication, and repository identity. +4. **Enforce review** - Protect factory-definition and pull request merges. +5. **Validate operations** - Test egress, isolation, rotation, capacity, observability, and metering. ## Related pages * [**Deployment patterns**](/factories/deployment-patterns/) - Compare Warp-hosted, managed self-hosted, and CLI-only execution. * [**Managed self-hosting**](/factories/self-hosting/) - Choose a worker backend and follow its setup guide. * [**Execution security**](/platform/execution-security/) - Review data boundaries, network egress, and backend-specific controls. -* [**Bring Your Own LLM**](/enterprise/enterprise-features/bring-your-own-llm/) - Compare customer-owned inference options and provider support. -* [**Enterprise security overview**](/enterprise/security-and-compliance/security-overview/) - Review data handling, ZDR, compliance, and access controls across Warp. -* [Team-managed model keys and endpoints](/enterprise/enterprise-features/team-managed-keys-and-endpoints/) - Configure customer-supplied inference credentials. diff --git a/src/content/docs/factories/integrations/jira.mdx b/src/content/docs/factories/integrations/jira.mdx index 9e6898b57..e3330da1f 100644 --- a/src/content/docs/factories/integrations/jira.mdx +++ b/src/content/docs/factories/integrations/jira.mdx @@ -21,9 +21,9 @@ Connect Jira Cloud to your factory so your team can start factory work without l 1. **Choose who connects Jira.** Open Jira during factory setup or from the workspace's **Integrations** page. If you are a Jira site admin, continue directly. Otherwise, choose **Someone else**. -2. **Send the setup to a Jira site admin.** Enter the Atlassian site, then email one or more site admins or copy an approval link to send to a site admin yourself. Links expire seven days after the request is created. While setup is pending, you can add recipients, resend or revoke an emailed link, copy or reset your own link, or revoke the request. +2. **Send the setup to a Jira site admin.** Enter the Atlassian site, then email one or more site admins or copy an approval link to send to a site admin yourself. -3. **Install Warp for Jira and connect the site.** The site admin completes these steps in the direct setup flow or from the approval link, without using your Warp session. Once connected, every factory in the workspace can use Jira. The [Jira integration setup](/platform/integrations/jira/#setup) explains the direct installation steps. That page's `warp-agent` label flow starts standalone cloud agent runs; factories skip the label and use an automation instead. +3. **Install Warp for Jira and connect the site.** The site admin completes these steps in the direct setup flow or from the approval link, without using your Warp session. Once connected, every factory in the workspace can use Jira. The [Jira integration setup](/platform/integrations/jira/#setup) explains the direct installation steps. 4. **Connect Jira to this factory.** A workspace connection makes Jira available to your factories, but each one opts in separately: in the factory's **Settings**, connect **Jira** and select the projects that should trigger it. @@ -54,6 +54,10 @@ Connect Jira Cloud to your factory so your team can start factory work without l {/* VISUAL: A Jira work item assigned to Warp, showing the resulting agent session. */} +Setup links expire seven days after the request is created. While setup is pending, you can add recipients, resend or revoke an emailed link, copy or reset your own link, or revoke the request. + +The Jira platform integration guide's `warp-agent` label flow starts standalone cloud agent runs. Factories skip the label and use an automation instead. + ## Filter which sessions start runs All Jira work reaches the factory through a single event, `agent_session_created`, which fires when someone assigns or mentions **Warp** on a work item. A session starts a run only when it matches an enabled automation. Use the trigger's `filter` to narrow what matches: diff --git a/src/content/docs/factories/integrations/teams.mdx b/src/content/docs/factories/integrations/teams.mdx index 5473b16cd..3168fcf7a 100644 --- a/src/content/docs/factories/integrations/teams.mdx +++ b/src/content/docs/factories/integrations/teams.mdx @@ -10,6 +10,12 @@ import { VARS } from '@data/vars'; Connect a factory to Microsoft Teams so your team can send work from channel conversations. Mention the Warp app in a configured standard or shared channel, and the factory replies in the same thread. +## Who completes each part + +* **Warp workspace admin** - Starts the connection and connects the installed team to the workspace. +* **Teams admin or team owner** - Downloads and adds the Warp app. A Teams admin uploads and approves it. +* **Factory editor** - Selects the connected teams and channels for the factory. + :::caution The integration supports standard and shared channels. Private channels and direct messages are not supported. ::: @@ -20,9 +26,9 @@ The integration supports standard and shared channels. Private channels and dire 2. **Choose who completes setup.** A workspace admin starts the connection. If that person is also a Teams admin or team owner, they can continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. 3. **Download the Warp app package.** The person completing setup signs in with Microsoft and clicks **Download Warp app package**. The `warp-microsoft-teams-app.zip` package contains the app manifest and icons, with no executable files. A delegated recipient does this from the setup link without using your Warp session. 4. **Upload and approve the app.** A Teams admin opens the [Teams admin center](https://admin.teams.microsoft.com), goes to **Teams apps** > **Manage apps**, clicks **Upload new app**, and uploads and approves the package. -5. **Add Warp to each team.** In Microsoft Teams, you or a Teams admin opens **Apps** > **Built for your org** > **Warp**, then clicks **Add** for every team the factory should use. +5. **Add Warp to each team.** In Microsoft Teams, a Teams admin or team owner opens **Apps** > **Built for your org** > **Warp**, then clicks **Add** for every team the factory should use. 6. **Connect the installed team to the Warp workspace.** Return to the setup flow, select the team, and connect it. A delegated recipient finishes from the approval link. For direct setup, the workspace admin selects the team on the top-level **Integrations** page and clicks **Enable**. -7. **Select teams and channels for the factory.** While creating the factory, or from the factory's **Settings**, choose **Microsoft Teams**, select the connected teams, and select at least one standard channel in each team. Click **Enable** or finish factory setup. +7. **Select teams and channels for the factory.** A factory editor chooses **Microsoft Teams** while creating the factory or from the factory's **Settings**, selects the connected teams and at least one standard channel in each team, then clicks **Enable** or finishes factory setup. Warp creates an enabled **teams-app-mentions** automation for the teams and channels selected in the last step. @@ -36,6 +42,8 @@ Warp creates an enabled **teams-app-mentions** automation for the teams and chan * **Start work** - Mention **@Warp** in a configured channel or thread. The factory includes supported attachments and replies in the same thread. Unsupported attachments don't block the request text. * **Continue work** - Reply in a thread that already has a factory work item. When responses to thread replies are enabled, eligible replies continue that work without another mention. +* **Use shared channels** - New root messages in shared channels still require an explicit **@Warp** mention. See the [shared-channel rules](#use-shared-channels). +* **Review results** - Follow progress and the final response in Teams. For code changes, the factory can also open a pull request. Automation-started work runs as the factory agent selected in that automation. To manage your account link, mention **@Warp** with `sign in`, `sign out`, or `help` in a channel where the app is installed. For `sign in`, follow the private link, then send your request again. `sign out` unlinks your account from every factory in that Microsoft organization. diff --git a/src/content/docs/factories/quickstart.mdx b/src/content/docs/factories/quickstart.mdx index 98539182a..5bca3ec50 100644 --- a/src/content/docs/factories/quickstart.mdx +++ b/src/content/docs/factories/quickstart.mdx @@ -13,7 +13,7 @@ Create a factory and take one small work item from prompt to pull request in abo ## Prerequisites * **A Warp account and team** - Get started with Warp, then join or create the team that will own the factory. -* **Permission to create factories** - Team and workspace admins, plus members whose team-level Warp Factories role is Editor, can create a factory. Members whose team-level role is User can view and run factories but cannot create one. See [factory roles and team permissions](/factories/infrastructure-and-security/#governance-and-metering). +* **Permission to create factories** - You need a team or workspace admin role, or the team-level Warp Factories Editor role. See [factory roles and permissions](/factories/infrastructure-and-security/#factory-roles-and-permissions). * **Available team usage** - The factory's agents consume the team's [credits](/support-and-community/plans-and-billing/platform-credits/). * **Repository access** - Authorize GitHub, GitLab, or Azure DevOps during setup. Restricted organizations need owner approval. Azure DevOps also requires [one-time administrator approval](/factories/integrations/azure-devops/#requirements). diff --git a/src/content/docs/factories/troubleshooting.mdx b/src/content/docs/factories/troubleshooting.mdx index 075d197a6..d32d4e782 100644 --- a/src/content/docs/factories/troubleshooting.mdx +++ b/src/content/docs/factories/troubleshooting.mdx @@ -16,7 +16,7 @@ Fix the problems teams hit most often when setting up a factory and running thei **Cause:** Creating a factory requires a team or workspace admin role, or the team-level Warp Factories Editor role. Configuring an existing factory requires its Editor or Admin role. -**Fix:** Ask a team or workspace admin to set your team-level Warp Factories role to Editor. To configure an existing factory, ask an Admin for that factory to set your role to Editor. See [factory roles and team permissions](/factories/infrastructure-and-security/#governance-and-metering). +**Fix:** Ask a team or workspace admin to set your team-level Warp Factories role to Editor. To configure an existing factory, ask an Admin for that factory to set your role to Editor. See [factory roles and permissions](/factories/infrastructure-and-security/#factory-roles-and-permissions). ### A repository doesn't appear in the picker From bd65cf95c90eb8b2d86475162dfab043c2c7f185 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:40:01 +0000 Subject: [PATCH 10/16] docs: correct Factories setup instructions --- src/content/docs/factories/index.mdx | 2 +- src/content/docs/factories/integrations/teams.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index d98a630c0..cda4c98be 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -16,7 +16,7 @@ A factory is a group of agents that shares repositories and delivery policy. Its {VARS.FACTORY_WEB_APP}. If **Microsoft Teams** doesn't appear, contact sales. -2. **Choose who completes setup.** A workspace admin starts the connection. If that person is also a Teams admin or team owner, they can continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. +2. **Choose who completes setup.** A workspace admin opens the **Microsoft Teams** integration and clicks **Connect**. If that person is also a Teams admin or team owner, they can continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. 3. **Download the Warp app package.** The person completing setup signs in with Microsoft and clicks **Download Warp app package**. The `warp-microsoft-teams-app.zip` package contains the app manifest and icons, with no executable files. A delegated recipient does this from the setup link without using your Warp session. 4. **Upload and approve the app.** A Teams admin opens the [Teams admin center](https://admin.teams.microsoft.com), goes to **Teams apps** > **Manage apps**, clicks **Upload new app**, and uploads and approves the package. 5. **Add Warp to each team.** In Microsoft Teams, a Teams admin or team owner opens **Apps** > **Built for your org** > **Warp**, then clicks **Add** for every team the factory should use. From 3a550b63f077c1cc2fb0846c809cb829c614d582 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:43:21 +0000 Subject: [PATCH 11/16] docs: compress Teams setup guidance Co-Authored-By: Oz --- .../docs/factories/integrations/teams.mdx | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/src/content/docs/factories/integrations/teams.mdx b/src/content/docs/factories/integrations/teams.mdx index 3625981a4..139205348 100644 --- a/src/content/docs/factories/integrations/teams.mdx +++ b/src/content/docs/factories/integrations/teams.mdx @@ -8,7 +8,7 @@ sidebar: --- import { VARS } from '@data/vars'; -Connect a factory to Microsoft Teams so your team can send work from channel conversations. Mention the Warp app in a configured standard or shared channel, and the factory replies in the same thread. +Connect a factory to Microsoft Teams so mentions in standard and shared channels start work and receive replies in the same thread. ## Who completes each part @@ -22,13 +22,13 @@ The integration supports standard and shared channels. Private channels and dire ## Set up Microsoft Teams -1. **Enable Microsoft Teams for the Warp workspace.** A workspace admin opens the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}. If **Microsoft Teams** doesn't appear, contact sales. -2. **Choose who completes setup.** A workspace admin opens the **Microsoft Teams** integration and clicks **Connect**. If that person is also a Teams admin or team owner, they can continue directly. Otherwise, choose **Someone else** and email a Teams admin or team owner a setup request, or copy an approval link. Links expire after seven days. -3. **Download the Warp app package.** The person completing setup signs in with Microsoft and clicks **Download Warp app package**. The `warp-microsoft-teams-app.zip` package contains the app manifest and icons, with no executable files. A delegated recipient does this from the setup link without using your Warp session. -4. **Upload and approve the app.** A Teams admin opens the [Teams admin center](https://admin.teams.microsoft.com), goes to **Teams apps** > **Manage apps**, clicks **Upload new app**, and uploads and approves the package. -5. **Add Warp to each team.** In Microsoft Teams, a Teams admin or team owner opens **Apps** > **Built for your org** > **Warp**, then clicks **Add** for every team the factory should use. -6. **Connect the installed team to the Warp workspace.** Return to the setup flow, select the team, and connect it. A delegated recipient finishes from the approval link. For direct setup, the workspace admin selects the team on the top-level **Integrations** page and clicks **Enable**. -7. **Select teams and channels for the factory.** A factory editor chooses **Microsoft Teams** while creating the factory or from the factory's **Settings**, selects the connected teams and at least one standard channel in each team, then clicks **Enable** or finishes factory setup. +1. **Enable Microsoft Teams for the Warp workspace.** A workspace admin opens **Integrations** in the {VARS.FACTORY_WEB_APP}. If **Microsoft Teams** is unavailable, contact sales. +2. **Choose who completes setup.** A workspace admin opens **Microsoft Teams** and clicks **Connect**. If they also administer Teams, continue. Otherwise, choose **Someone else** and email the setup request or copy its approval link for a Teams admin or team owner. Links expire after seven days. +3. **Download the Warp app package.** Sign in with Microsoft and download `warp-microsoft-teams-app.zip`. It contains the app manifest and icons, with no executable files. A delegated recipient uses the approval link without your Warp session. +4. **Upload and approve the app.** In the [Teams admin center](https://admin.teams.microsoft.com), go to **Teams apps** > **Manage apps**, click **Upload new app**, then upload and approve the package. +5. **Add Warp to each team.** In Microsoft Teams, open **Apps** > **Built for your org** > **Warp**, then add Warp to each team the factory should use. +6. **Connect the installed team to the Warp workspace.** Back in setup, select and connect the team. A delegated recipient uses the approval link; direct setup requires a workspace admin to select the team under **Integrations** and click **Enable**. +7. **Select teams and channels for the factory.** During factory creation or in the factory's **Settings**, an editor chooses **Microsoft Teams**, selects the connected teams and at least one standard channel in each, then clicks **Enable**. Warp creates an enabled **teams-app-mentions** automation for the teams and channels selected in the last step. @@ -42,8 +42,8 @@ Warp creates an enabled **teams-app-mentions** automation for the teams and chan * **Start work** - Mention **@Warp** in a configured channel or thread. The factory includes supported attachments and replies in the same thread. Unsupported attachments don't block the request text. * **Continue work** - Reply in a thread that already has a factory work item. When responses to thread replies are enabled, eligible replies continue that work without another mention. -* **Use shared channels** - New root messages in shared channels still require an explicit **@Warp** mention. See the [shared-channel rules](#use-shared-channels). -* **Review results** - Follow progress and the final response in Teams. For code changes, the factory can also open a pull request. +* **Use shared channels** - Root messages require **@Warp**. See the [shared-channel rules](#use-shared-channels). +* **Review results** - Follow progress and results in Teams. Code changes can also open a pull request. Automation-started work runs as the factory agent selected in that automation. To manage your account link, mention **@Warp** with `sign in`, `sign out`, or `help` in a channel where the app is installed. For `sign in`, follow the private link, then send your request again. `sign out` unlinks your account from every factory in that Microsoft organization. From 63e09a0a4e1471f632b2857e666bcbf98a429098 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 20:04:06 +0000 Subject: [PATCH 12/16] docs: clarify Factories CTA audiences Co-Authored-By: Oz --- src/content/docs/factories/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index cda4c98be..b4fffd925 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -16,12 +16,12 @@ A factory is a group of agents that shares repositories and delivery policy. Its From 87a2c0f0ba40b8093daab30a9c4c2ebfc07a6775 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 20:05:50 +0000 Subject: [PATCH 13/16] docs: balance Factories CTA copy Co-Authored-By: Oz --- src/content/docs/factories/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/factories/index.mdx b/src/content/docs/factories/index.mdx index b4fffd925..d0945518f 100644 --- a/src/content/docs/factories/index.mdx +++ b/src/content/docs/factories/index.mdx @@ -16,12 +16,12 @@ A factory is a group of agents that shares repositories and delivery policy. Its From 9fb9c5fc9a5cc219da531c3710e1944e5da54db8 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 20:08:28 +0000 Subject: [PATCH 14/16] docs: refine Factories access and setup guidance Co-Authored-By: Oz --- .../factories/infrastructure-and-security.mdx | 14 +++-- .../docs/factories/integrations/jira.mdx | 53 +++++++++---------- src/sidebar.ts | 1 + 3 files changed, 35 insertions(+), 33 deletions(-) diff --git a/src/content/docs/factories/infrastructure-and-security.mdx b/src/content/docs/factories/infrastructure-and-security.mdx index 004a35030..c4a4af401 100644 --- a/src/content/docs/factories/infrastructure-and-security.mdx +++ b/src/content/docs/factories/infrastructure-and-security.mdx @@ -7,11 +7,11 @@ sidebar: label: "Infrastructure & security" --- -Warp Factories runs on the infrastructure your team chooses. You decide where a factory runs code, which model providers serve its inference requests, and which credentials each agent receives. Warp coordinates the work and stores run data such as transcripts and artifacts. +Warp Factories separates execution, inference, and credential boundaries. You choose where code runs, which providers serve inference, and which credentials each agent receives. Warp coordinates the work and stores transcripts and artifacts. ## Control plane and execution plane -Every factory splits responsibilities across two planes: +Each factory uses two planes: * **Control plane** - Warp coordinates runs, identity and configuration, observability, integrations, storage, and inference routing. * **Execution plane** - A Warp-hosted sandbox or a managed self-hosted worker checks out code, runs setup, invokes tools, builds the project, and executes commands. @@ -135,6 +135,10 @@ Warp meters hosted compute, Warp-provided inference, and platform services. Self ## Related pages -* [**Deployment patterns**](/factories/deployment-patterns/) - Compare Warp-hosted, managed self-hosted, and CLI-only execution. -* [**Managed self-hosting**](/factories/self-hosting/) - Choose a worker backend and follow its setup guide. -* [**Execution security**](/platform/execution-security/) - Review data boundaries, network egress, and backend-specific controls. +* [**Deployment patterns**](/factories/deployment-patterns/) - Compare execution and inference boundaries. +* [**Runners**](/factories/runners/) - Configure compute and worker compatibility. +* [**Managed self-hosting**](/factories/self-hosting/) - Deploy and operate a worker backend. +* [**Execution security**](/platform/execution-security/) - Review data boundaries, egress, and backend controls. +* [**Team-managed model keys and endpoints**](/enterprise/enterprise-features/team-managed-keys-and-endpoints/) - Configure inference credentials. +* [**Roles and permissions**](/enterprise/team-management/roles-and-permissions/) - Govern team and workspace resources. +* [**Platform credits**](/support-and-community/plans-and-billing/platform-credits/) - Understand factory metering. diff --git a/src/content/docs/factories/integrations/jira.mdx b/src/content/docs/factories/integrations/jira.mdx index e3330da1f..1c06677da 100644 --- a/src/content/docs/factories/integrations/jira.mdx +++ b/src/content/docs/factories/integrations/jira.mdx @@ -13,50 +13,47 @@ Connect Jira Cloud to your factory so your team can start factory work without l ## Prerequisites * **Jira Cloud** - The integration supports Jira Cloud only, not Jira Server or Data Center. -* **A Jira site admin** - Installing the Warp app on a Jira site and connecting it to a Warp workspace requires site admin permissions. If you are not a site admin, you can send the setup to one instead. +* **A Jira site admin** - A site admin must install the Warp app and connect the Jira site to your Warp workspace. * **A factory** - You need a factory in the connected workspace and permission to edit its [definition](/factories/factory-as-code/). * **The Warp agent in Jira** - The **Warp** agent must be available on your Jira site so people can assign or mention it on work items. Jira lists it among Atlassian's Rovo agents. ## Connect Jira and add an automation -1. **Choose who connects Jira.** Open Jira during factory setup or from the workspace's **Integrations** page. If you are a Jira site admin, continue directly. Otherwise, choose **Someone else**. +1. **Open Jira setup.** Choose **Jira** while creating a factory. To connect it later, open the top-level **Integrations** page in the {VARS.FACTORY_WEB_APP}, find **Jira**, and click **Connect**. +2. **Install Warp for Jira and connect the site.** A Jira site admin installs the app on the Jira Cloud site. In Jira, open **Apps** > **Manage apps** > **Warp** > **Configure**, then click **Connect to Warp**. Once connected, Jira is available to every factory in the workspace. See the [Jira installation steps](/platform/integrations/jira/#setup) for the full app flow. -2. **Send the setup to a Jira site admin.** Enter the Atlassian site, then email one or more site admins or copy an approval link to send to a site admin yourself. +If you aren't a Jira site admin, choose **Someone else** during setup and email the request or copy the approval link to a site admin. The link expires after seven days, and you can resend or revoke it while the request is pending. -3. **Install Warp for Jira and connect the site.** The site admin completes these steps in the direct setup flow or from the approval link, without using your Warp session. Once connected, every factory in the workspace can use Jira. The [Jira integration setup](/platform/integrations/jira/#setup) explains the direct installation steps. +3. **Connect Jira to the factory.** In the factory dashboard, open **Settings** > **Integrations**, connect **Jira**, select the projects this factory works with, then click **Enable**. If you connected Jira while creating the factory, select the projects before finishing setup. Each factory opts in separately even though the Jira site is connected to the workspace. -4. **Connect Jira to this factory.** A workspace connection makes Jira available to your factories, but each one opts in separately: in the factory's **Settings**, connect **Jira** and select the projects that should trigger it. +4. **Configure the Jira automation.** In the factory dashboard, open **Automations**. If you selected Jira projects during factory creation, edit the existing Jira automation. Otherwise, add a trigger for **Jira** > **Agent session created**. Choose the agent that handles the work, select the projects, and optionally add keywords to narrow which sessions start runs. -5. **Point an automation at Jira.** In the factory's dashboard, open **Automations** and add a trigger for **Jira** > **Agent session created**. Use **Projects** and, optionally, **Keywords** to scope which sessions start a run, and choose the agent that handles them. +5. **Test the connection.** Assign or mention **Warp** on a work item and include an instruction. Jira starts an agent session, and the run appears under the matching automation in your factory. - If you picked Jira projects when you created the factory, that automation already exists. Edit it rather than adding a second one. - - To set this up in code instead, declare the `jira` integration in the factory's `factory.yaml` (`integrations: [{type: jira}]`), then add a file under `automations/`, such as `automations/jira-assignment/automation.md`, with an `agent_session_created` trigger: - - ```markdown title="automations/jira-assignment/automation.md" - --- - enabled: true - agent: foreman - triggers: - - provider: jira - event: agent_session_created - filter: - project_keys: [ENG] - keywords: [investigate, fix] - --- + {/* VISUAL: A Jira work item assigned to Warp, showing the resulting agent session. */} - Handle the Jira assignment and return a concise result. - ``` +The standalone Jira integration uses the `warp-agent` label to start cloud agent runs. Factories use an automation instead. - With this automation, the agent named `foreman` handles sessions for work items in the `ENG` project whose assignment text contains `investigate` or `fix`. Commit and push the files to apply them; see [definitions as code](/factories/factory-as-code/) for the full syntax. +### Configure the automation as code -6. **Test it.** Assign or mention **Warp** on a work item and include an instruction. Jira starts an agent session, and the run appears under the matching automation in your factory. +Declare the `jira` integration in `factory.yaml` (`integrations: [{type: jira}]`), then add a file under `automations/`, such as `automations/jira-assignment/automation.md`, with an `agent_session_created` trigger: - {/* VISUAL: A Jira work item assigned to Warp, showing the resulting agent session. */} +```markdown title="automations/jira-assignment/automation.md" +--- +enabled: true +agent: foreman +triggers: + - provider: jira + event: agent_session_created + filter: + project_keys: [ENG] + keywords: [investigate, fix] +--- -Setup links expire seven days after the request is created. While setup is pending, you can add recipients, resend or revoke an emailed link, copy or reset your own link, or revoke the request. +Handle the Jira assignment and return a concise result. +``` -The Jira platform integration guide's `warp-agent` label flow starts standalone cloud agent runs. Factories skip the label and use an automation instead. +This automation sends Jira sessions from the `ENG` project to the agent named `foreman` when their assignment text contains `investigate` or `fix`. Commit and push the files to apply them. See [definitions as code](/factories/factory-as-code/) for the full syntax. ## Filter which sessions start runs diff --git a/src/sidebar.ts b/src/sidebar.ts index e3832b2e0..309a59bf3 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -387,6 +387,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ label: 'Factories', link: '/factories/', icon: 'setting', + badge: { text: 'Early Access', variant: 'note' }, // Group labels are noun phrases naming a subject area, not imperative // verbs. Every other tab does this -- 'Agent configuration', // 'Triggers & integrations', 'Plans and billing', 'Team management' -- From d5d59a24a1f3717f8353126eed4d24be4b00f521 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 20:11:04 +0000 Subject: [PATCH 15/16] docs: keep Factories access badge removed Co-Authored-By: Oz --- src/sidebar.ts | 1 - 1 file changed, 1 deletion(-) diff --git a/src/sidebar.ts b/src/sidebar.ts index 309a59bf3..e3832b2e0 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -387,7 +387,6 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ label: 'Factories', link: '/factories/', icon: 'setting', - badge: { text: 'Early Access', variant: 'note' }, // Group labels are noun phrases naming a subject area, not imperative // verbs. Every other tab does this -- 'Agent configuration', // 'Triggers & integrations', 'Plans and billing', 'Team management' -- From 7b5fb65b401f41bf14677c7d77bcc1ad9314cce8 Mon Sep 17 00:00:00 2001 From: "warp-agent-staging[bot]" <240773466+warp-agent-staging[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 20:13:55 +0000 Subject: [PATCH 16/16] docs: retain Factories Early Access badge Co-Authored-By: Oz --- src/sidebar.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/src/sidebar.ts b/src/sidebar.ts index e3832b2e0..309a59bf3 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -387,6 +387,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ label: 'Factories', link: '/factories/', icon: 'setting', + badge: { text: 'Early Access', variant: 'note' }, // Group labels are noun phrases naming a subject area, not imperative // verbs. Every other tab does this -- 'Agent configuration', // 'Triggers & integrations', 'Plans and billing', 'Team management' --