Skip to content

docs: add AEO cross-links for agents and orchestration - #741

Draft
warp-factories[bot] wants to merge 1 commit into
mainfrom
docs/aeo-crosslinks-agents-orchestration-2026-09-14
Draft

warp-factories[bot] wants to merge 1 commit into
mainfrom
docs/aeo-crosslinks-agents-orchestration-2026-09-14

Conversation

@warp-factories

@warp-factories warp-factories Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a small set of internal cross-links for agents, cloud agents, and orchestration docs based on Peec (last 30 days) and Google Search Console signals.

AEO brief

Goal: Identify small internal cross-link improvements for agents, cloud agents, and orchestration docs.

Recommendation: Update existing pages only (no new pages).

Source signals:

  • Peec topics: Cloud Agent Orchestration, Coding Agents, Software Factory, Agentic Development Environments. Query themes include multi-agent/orchestration, software factory, background/scheduled agents, coding agents, and handoff.
  • GSC (sc-domain:warp.dev, ~28 days): top docs traffic includes /factories/, multi-agent guide, remote control, CLI agents, and /platform/orchestration/. Branded queries include "warp factory", "warp agent orchestration", "warp cloud agents", "scheduled agents".
  • Existing-docs gaps: Computer Use lists schedules/integrations/harnesses without links; cloud agents overview describes parallelism without an orchestration link and omits Factories from Learn more; Agent Memory and unattended-agents mention schedules/integrations/orchestration destinations without linking them.

Vocabulary map:

  • Users/answer engines say: multi agent orchestration, software factory, cloud agents, scheduled agents
    Docs should say: multi-agent orchestration, Warp Factories, cloud agents, scheduled agents

Content scope:

  • Include - Natural inline links where the source page already names the destination concept.
  • Avoid - New pages, rewrites, keyword stuffing, related-link list spam.

Pages touched:

  • src/content/docs/agents/capabilities/computer-use/index.mdx - schedules, integrations, and harnesses already named on-page.
  • src/content/docs/platform/index.mdx - parallelism use case and Learn more hub.
  • src/content/docs/agents/agent-memory/index.mdx - where memory runs across cloud triggers.
  • src/content/docs/guides/agent-workflows/how-to-run-unattended-agents.mdx - next step after triggers for large parallel work.

Links added:

  1. Computer Use → /platform/harnesses/ — reader configuring CU for Claude Code/Codex needs harness docs.
  2. Computer Use → /platform/triggers/scheduled-agents/ — web-app CU toggle for scheduled runs.
  3. Computer Use → /platform/integrations/ — CU for integration-triggered agents.
  4. Cloud agents overview parallelism bullet → /platform/orchestration/ — next step for concurrent/fan-out cloud work.
  5. Cloud agents overview Learn more → /factories/ — productized multi-agent workflow on the same platform (top GSC docs page).
  6. Agent Memory → /platform/, schedules, integrations — where shared memory applies for background runs.
  7. Run unattended agents Next steps → /platform/orchestration/ — fan-out after choosing a trigger.

Reader next step:

  • From Computer Use setup, configure schedules/integrations/harnesses correctly.
  • From cloud agents overview, continue into orchestration or Factories.
  • From Agent Memory, understand which cloud surfaces share memory.
  • From unattended agents, scale a single trigger into parent/child runs.

Open questions for human review:

  • Is the Factories Learn more placement on the cloud agents overview the preferred hub link, or should it stay only under agents overview / platform overview?

Changes

  • 4 pages, cross-links only (no structural rewrites)

Unverified claims

None. No new technical claims; links target existing pages only.

Documentation risk

Risk: low
Rationale: Cross-link-only edits to existing pages; descriptive links to existing canonical docs with no new product claims, commands, UI labels, or behavior changes.
Docs override: none

Link computer-use, cloud agents overview, agent memory, and unattended
agents pages to harnesses, schedules, integrations, orchestration, and
factories based on Peec and GSC signals.
@cla-bot cla-bot Bot added the cla-signed label Sep 14, 2026
@vercel

vercel Bot commented Sep 14, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
docs Ready Ready Preview Sep 14, 2026 3:16pm UTC

Request Review

@warp-factories warp-factories Bot added the warpy-factory Opened by the Warp factory agents label Sep 14, 2026
@warp-factories

Copy link
Copy Markdown
Contributor Author

This PR was generated with Warp.

Comment @warp-agent on this PR to send it follow-up work.

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

Labels

cla-signed warpy-factory Opened by the Warp factory agents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants