Skip to content

Add internal cross-links for agent scheduling, monitoring, and triggers#176

Closed
rachaelrenk wants to merge 1 commit into
mainfrom
aeo/cross-link-agents-orchestration
Closed

Add internal cross-links for agent scheduling, monitoring, and triggers#176
rachaelrenk wants to merge 1 commit into
mainfrom
aeo/cross-link-agents-orchestration

Conversation

@rachaelrenk

Copy link
Copy Markdown
Contributor

Summary

Adds 4 internal cross-links across 2 pages to improve navigation between agent scheduling, monitoring, and trigger docs.

Source signals

  • Peec AEO snapshot (buzz:rachael/aeo-snapshot-pilot, aeo-snapshots/docs/agents-orchestration/latest.json, generated 2026-06-04, window 2026-05-05 to 2026-06-04): high-volume prompt signals for monitoring/observing agents in real time, triggering agents from Slack/Linear/GitHub, and managing multiple agents.
  • Google Search Console (2026-05-05 to 2026-06-03): confirmed traffic to cloud-agents/overview, cloud-agents/agents, and cloud-agents/integrations/ pages; orchestration-related queries landing on the how-to-run-multiple-agents guide.

Changes

scheduled-agents.mdx (2 links added):

  1. Execution model section → linked to Agent Management Panel and cloud agent session sharing so readers can find run review surfaces after learning about scheduled run behavior.
  2. "When to use Scheduled Agents vs triggers" section → linked "triggered cloud agents" to the Integrations overview so the comparison has a concrete destination.

agents.mdx (2 links added):
3. "Where cloud agents appear in the product" section → linked "Runs view" to Managing cloud agents and "individual run detail pages" to Viewing cloud agent runs.

Pages inspected (no change needed)

  • cloud-agents/overview.mdx — already well cross-linked to all relevant targets
  • cloud-agents/orchestration/index.mdx — already links to managing, overview, deployment, multi-agent runs, and guide
  • cloud-agents/orchestration/multi-agent-runs.mdx — already links to orchestration, managing, environments, CLI, API
  • cloud-agents/managing-cloud-agents.mdx — already links to overview, orchestration, viewing runs, handoff, oz-web-app
  • cloud-agents/viewing-cloud-agent-runs.mdx — already links to managing, session sharing, attach-session guide
  • cloud-agents/integrations/slack.mdx — already links to viewing-cloud-agent-runs, oz-web-app
  • cloud-agents/integrations/linear.mdx — already links to viewing-cloud-agent-runs, oz-web-app
  • cloud-agents/integrations/github-actions.mdx — already links to unattended-agents guide, skills, API keys
  • cloud-agents/skills-as-agents.mdx — already links to scheduled-agents, environments, CLI
  • cloud-agents/triggers/index.mdx — already links to scheduled-agents, CLI, API, integrations
  • cloud-agents/triggers/scheduled-agents-quickstart.mdx — already links to scheduled-agents, integrations-quickstart, unattended-agents guide
  • guides/agent-workflows/how-to-run-unattended-agents.mdx — hub page, already cross-linked to all trigger types
  • guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx — already cross-linked to orchestration, managing, oz-web-app

Rejected candidates

  • orchestration/index.mdx line 32 mentions "Slack, Linear, a schedule, or the API" inline but the context is describing execution combinations, not recommending those pages — linking would be link-stuffing.
  • viewing-cloud-agent-runs.mdx doesn't mention scheduled triggers, but adding a schedule link would be tangential to the page's focus on session sharing.
  • triggers/index.mdx is a concise 4-bullet index page — adding monitoring links would change its purpose.

Validation

  • All 4 link target files verified to exist on disk
  • git diff --check clean (no whitespace errors)

Conversation: https://app.warp.dev/conversation/5a63bf1a-fe92-4d3a-b25c-5d69b0e866f6
Run: https://oz.warp.dev/runs/019e9342-db77-7e91-a63f-bfbe88c34da7

This PR was generated with Oz.

…igger docs

Adds 4 internal links across 2 pages, guided by the Peec AEO snapshot
for agents/cloud-agents/orchestration (2026-05-05 to 2026-06-04) and
Google Search Console data for docs.warp.dev/agent-platform/cloud-agents.

Scheduled Agents page:
- Link to Agent Management Panel and cloud agent session sharing from
  the execution model section so readers can find run review surfaces.
- Link 'triggered cloud agents' to the Integrations overview in the
  comparison section.

Agents page:
- Link 'Runs view' and 'individual run detail pages' in the product
  surfaces section to their respective docs pages.

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Jun 4, 2026
@vercel

vercel Bot commented Jun 4, 2026

Copy link
Copy Markdown

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

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

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant