diff --git a/src/content/docs/agent-platform/capabilities/planning.mdx b/src/content/docs/agent-platform/capabilities/planning.mdx
index bfe4738d..309264cd 100644
--- a/src/content/docs/agent-platform/capabilities/planning.mdx
+++ b/src/content/docs/agent-platform/capabilities/planning.mdx
@@ -113,3 +113,4 @@ As the agent executes your plan, you'll review code changes and may want to scal
 
 * **[Interactive Code Review](/agent-platform/local-agents/interactive-code-review/)** - Leave inline comments on agent-generated diffs and have the agent revise in one pass.
 * **[Cloud Agents quickstart](/agent-platform/cloud-agents/quickstart/)** - Run agents in the cloud for longer tasks, background automation, or parallel work across repos.
+* **[Multi-agent orchestration](/agent-platform/cloud-agents/orchestration/)** - When `/plan` detects that a task benefits from parallel work, it proposes an orchestration config that spawns child agents to divide the work.
diff --git a/src/content/docs/agent-platform/cloud-agents/environments.mdx b/src/content/docs/agent-platform/cloud-agents/environments.mdx
index cdd1440b..ea7639ca 100644
--- a/src/content/docs/agent-platform/cloud-agents/environments.mdx
+++ b/src/content/docs/agent-platform/cloud-agents/environments.mdx
@@ -64,7 +64,7 @@ Components in the execution flow:
 2. **Task** – Warp creates a tracked task for the run
 3. **Environment** – The task uses an environment to define execution context
 4. **Host** – The environment runs on a host (Warp-hosted or self-hosted infrastructure).
-5. **Agent execution** – The workflow runs in the prepared environment
+5. **Agent execution** – The workflow runs in the prepared environment. In [orchestrated runs](/agent-platform/cloud-agents/orchestration/), each child agent gets its own environment so that parallel agents are isolated from each other.
 6. **Outputs** – The run produces PRs, messages, reports, or transcripts
 
 :::note
diff --git a/src/content/docs/agent-platform/cloud-agents/harnesses/index.mdx b/src/content/docs/agent-platform/cloud-agents/harnesses/index.mdx
index deebccd1..2d08fd82 100644
--- a/src/content/docs/agent-platform/cloud-agents/harnesses/index.mdx
+++ b/src/content/docs/agent-platform/cloud-agents/harnesses/index.mdx
@@ -22,6 +22,7 @@ Third-party harnesses inherit the same Oz platform features as Warp Agent:
 * **Triggers** — Slack, Linear, schedules, CI, and API [triggers](/agent-platform/cloud-agents/triggers/) launch any harness.
 * **Environments and secrets** — Reuse the same [environments](/agent-platform/cloud-agents/environments/) and [agent secrets](/agent-platform/cloud-agents/secrets/).
 * **Skills and Rules** — Saved [Skills](/agent-platform/capabilities/skills/) and [Rules](/agent-platform/capabilities/rules/) apply across harnesses.
+* **Orchestration** — A parent agent running one harness can spawn child agents that run a [different harness](/agent-platform/cloud-agents/orchestration/#where-parent-and-child-agents-can-run).
 * **Observability** — Every run produces a transcript and shareable session in the [Oz dashboard](/agent-platform/cloud-agents/managing-cloud-agents/).
 
 ## Billing
diff --git a/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx b/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx
index 9a97d156..5d858a5a 100644
--- a/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx
+++ b/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx
@@ -102,7 +102,7 @@ The same agent capabilities that power interactive conversations in Warp also ru
 
 * React to events from Slack, Linear, or GitHub
 * Run on schedules for recurring tasks like dependency updates
-* Execute in parallel across repos or tasks
+* Execute in parallel across repos or tasks using [multi-agent orchestration](/agent-platform/cloud-agents/orchestration/)
 * Produce tracked, auditable, shareable runs
 
 Cloud agents are ideal for work that doesn't need your immediate attention—PR reviews, issue triage, routine maintenance, and integration-driven workflows.