docs: add AEO cross-links for agents and orchestration

[rachaelrenk]

AEO cross-link audit: agents and orchestration

Small, high-confidence internal cross-link additions for the agents, cloud agents, and orchestration topic area. Scope is limited to cross-linking existing pages — no new pages, no rewrites.

Goal

Identify small internal cross-link improvements for agents, cloud agents, and orchestration docs that help readers continue a real workflow.

Source signals

• Peec snapshot (buzz/aeo-snapshots/docs/agents-orchestration/latest.json, window 2026-05-05 to 2026-06-04). Dominant prompts: "how do I set up AI coding agents to run on a schedule or in the background?", "what's the best platform for scheduling and managing AI coding agents across a team?", "how do development teams track and observe what their AI coding agents are doing in real time?", and "what are the best tools for managing multiple AI coding agents?".
• Existing docs under src/content/docs/agent-platform/cloud-agents/ and src/content/docs/guides/agent-workflows/ to find source pages that already mention a concept whose destination page was not linked.
• Google Search Console: credentials were available in the environment, but no GSC query was run for this audit (no property/query tooling was provided to the run). Links here are grounded in Peec + existing-docs signals only.

Pages touched

• src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx — the CLI reference for Scheduled Agents did not link to the guided, no-CLI quickstart, despite scheduling being the strongest Peec signal cluster.
• src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx — an under-linked legacy guide (1 existing link) that mentions agent notifications and a run-review surface without linking either.

Links added

1. triggers/scheduled-agents.mdx → triggers/scheduled-agents-quickstart.mdx — gives readers on the CLI reference a path to the guided web-app setup. The reverse link (quickstart → reference) already exists, confirming the relationship.
2. guides/.../running-multiple-agents-at-once-with-warp.mdx → capabilities/agent-notifications.mdx — the page lists "Notifications when blocked or completed" but never linked the notifications setup doc.
3. guides/.../running-multiple-agents-at-once-with-warp.mdx → cloud-agents/managing-cloud-agents.mdx — the "Reviewing all active agents" section describes monitoring active/completed runs; the Agent Management Panel is the canonical observability surface (matches the Peec "observe in real time" / "managing multiple" signals).

Reader next step

• A reader reading the Scheduled Agents CLI reference who wants the fastest setup can jump straight to the quickstart.
• A reader running multiple agents who wants notifications can reach setup instructions; one who wants to track all runs across their account/team can reach the Agent Management Panel.

Open questions for human review

• The "Run multiple agents at once" guide uses legacy terminology ("Agent Mode Dashboard", "Task List panel"). This PR only adds cross-links and does not rename these; a follow-up could align them with current terminology (Agent Management Panel, Task lists).
• GSC was available but not queried. A future run with a defined property/query path could confirm or expand these links with live search-query data.

Follow-up recommendations (out of scope for this cross-link pilot)

• Consider a reverse cross-link from scheduled-agents.mdx / integrations pages to orchestration/ for the "managing multiple agents" cluster, if it reads as a natural next step rather than link stuffing.

---

Conversation: https://app.warp.dev/conversation/59a539f1-3676-4526-aade-d7038c0f4ae1
Run: https://oz.warp.dev/runs/019eca82-5919-7e6d-9c89-b586eea9db27

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 15, 2026 9:07am

[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 three targeted internal cross-links between existing Agent Platform and guide pages for scheduled agents, notifications, and agent management. The linked destinations exist and the added context is consistent with the source pages and the PR's AEO cross-linking scope.

Concerns

No blocking concerns found. No security findings were identified, and no approved or repository spec context was available for implementation drift review.

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