docs: add AEO cross-links for agents and orchestration

[rachaelrenk]

AEO cross-link audit: agents and orchestration

Goal

Identify small internal cross-linking improvements for agents, cloud agents, and orchestration docs, backed by Peec and Google Search Console signals.

Source signals

Peec (snapshot 2026-05-05 → 2026-06-04):

• "how do I set up AI coding agents to run on a schedule or in the background?" (high volume)
• "what's the best platform for scheduling and managing AI coding agents across a team?" (high volume)
• "how do I trigger AI coding agents automatically from Slack, Linear, or GitHub?" (high volume)
• "what are the best tools for managing multiple AI coding agents?" (high volume)

Google Search Console (2026-05-05 → 2026-06-03):

• "warp orchestration" → 13 impressions hitting homepage and /agent-platform/, 0 clicks to orchestration page
• "oz orchestration platform" → impressions on /agent-platform/cloud-agents/platform/, not the orchestration page
• "scheduled agent" / "how can i schedule overnight batch agents" → hitting scheduled agents pages (5–7 impressions)

Existing-docs signal:

• platform.mdx "Warp Orchestrator" section describes orchestration lifecycle but never links to /agent-platform/cloud-agents/orchestration/
• orchestration/index.mdx "Review swarm" pattern mentions "A scheduled or webhook-triggered parent" with no link to scheduling docs
• scheduled-agents.mdx "When to use" section mentions "triggered cloud agents" and "triggers for reactive workflows" with no links

Pages touched

• src/content/docs/agent-platform/cloud-agents/platform.mdx — Added bullet linking the Warp Orchestrator section to multi-agent orchestration docs. Reason: GSC shows orchestration queries hitting this page, but readers can't navigate to the orchestration docs from here.
• src/content/docs/agent-platform/cloud-agents/orchestration/index.mdx — Linked "scheduled" in the Review swarm pattern to the scheduled agents page. Reason: Peec prompt about scheduling agents maps directly to this pattern.
• src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx — Linked "triggered cloud agents" to integrations and "triggers" to triggers overview in the "When to use" section. Reason: Peec prompts about triggering from Slack/Linear/GitHub match this decision point.

Links added

Source page	Target page	Rationale
platform.mdx (Warp Orchestrator)	/agent-platform/cloud-agents/orchestration/	Orchestration queries land on platform page but can't navigate to orchestration docs
orchestration/index.mdx (Review swarm)	/agent-platform/cloud-agents/triggers/scheduled-agents/	Peec: high interest in scheduling + orchestration; pattern mentions scheduling without a link
scheduled-agents.mdx (When to use)	/agent-platform/cloud-agents/integrations/	Peec: high interest in triggering from Slack/Linear/GitHub; section mentions triggered agents without a link
scheduled-agents.mdx (When to use)	/agent-platform/cloud-agents/triggers/	Same section, connects reactive triggers to the overview page

Validation

• style_lint --all: 0 issues on changed files (419 pre-existing across repo)
• check_links --internal-only: 0 broken links (2890 internal links checked)
• git diff --check: clean

Open questions for human review

• The platform.mdx orchestrator section describes the platform's lifecycle layer, not multi-agent orchestration specifically. The added bullet connects them — verify this is the right framing vs. a separate subsection.
• Should the orchestration page's "Review swarm" pattern also link to the integrations page for webhook-triggered parents, or is that too many links in one sentence?

---

Conversation: https://app.warp.dev/conversation/476b8b48-9041-4498-86cf-a358b89434e4
Run: https://oz.warp.dev/runs/019e9377-0d17-7ccb-a5dc-34b701554b4d

This PR was generated with Oz.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jun 4, 2026 6:32pm

[oz-for-oss]

@rachaelrenk

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

[oz-for-oss]

Overview

This PR adds targeted internal cross-links between the cloud agents platform, orchestration, integrations, and triggers docs to improve AEO-driven navigation for scheduling and multi-agent workflow queries. The added links point to existing docs routes, preserve the surrounding meaning, and are supported by the source signals described in the PR body.

Concerns

• No blocking concerns found.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz