docs: add AEO cross-links for agents and orchestration - #775
Merged
Merged
Conversation
Link cloud-run inspection, Computer Use, handoff, and multi-agent orchestration pages that already describe related workflows.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Author
|
This PR was generated with Warp. Comment |
rachaelrenk
marked this pull request as ready for review
September 21, 2026 17:46
Contributor
|
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 Powered by Oz |
![warp-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Overview
This PR adds targeted internal cross-links across cloud agent runs, Computer Use, slash commands, multi-agent orchestration, and software factory docs. The changes are limited to existing pages and the added links resolve to existing documentation paths.
Concerns
- No blocking concerns found.
- No security findings; the diff only changes documentation cross-links and surrounding prose.
- No spec drift found;
spec_context.mdreports no approved or repository spec context for this PR. - No added or changed code comments or tests to evaluate.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
rachaelrenk
reviewed
Sep 21, 2026
rachaelrenk
reviewed
Sep 21, 2026
rachaelrenk
reviewed
Sep 21, 2026
rachaelrenk
reviewed
Sep 21, 2026
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Review summary
The independent agent completed its review for this commit.
Findings
src/content/docs/platform/viewing-cloud-agent-runs.mdx:108— [IMPORTANT] The Related pages bullet added here stacks three new link targets (Computer Use, Browser use, Testing and recordings) in a single item, and combined with the Computer Use link already added at line 27 this page gets 3 distinct new link targets / 4 insertions, exceeding the aeo_crosslink_audit skill's own density limit (1-2 preferred, no more than 3 without a hub/sparse-link exception, which doesn't apply since this page already had 5 pre-existing related links). Requested resolution: split into one link per bullet like the other four items in this list, or drop to a single Computer Use link here.src/content/docs/platform/viewing-cloud-agent-runs.mdx:27— [SUGGESTION] The added clause about Computer Use 'artifacts such as screenshots and recordings' is accurate but exceeds the skill's 'minimal surrounding copy' guidance and duplicates the detail now also added in the line-108 Related pages bullet. Requested resolution: trim this bullet to a short link-only mention, or keep the detail here and remove the duplicate Computer Use link from line 108.src/content/docs/guides/agent-workflows/run-a-software-factory-in-the-cloud.mdx:31— [SUGGESTION] '...steer a stuck agent, or hand the work off and pick up where the agent left off' states the same handoff action twice. Requested resolution: tighten to state the handoff capability once, e.g. 'steer a stuck agent, or hand the work off to keep going from another session.'
Verdict
Request changes
- Fix awkward link ordering in multi-agent guide fan-in step - Drop redundant 'run session' terminology in favor of 'session' - Tighten Computer Use artifacts bullet and fix duplicated wording Co-Authored-By: Warp <agent@warp.dev>
- Trim duplicated Computer Use artifact detail from the session-sharing bullet (now stated once, in Related pages) - Drop the Related pages Computer Use entry back to a single link instead of stacking three new link targets in one bullet - Fix redundant 'hand the work off and pick up where the agent left off' phrasing in the software factory cloud guide Co-Authored-By: Warp <agent@warp.dev>
rachaelrenk
approved these changes
Sep 21, 2026
Contributor
There was a problem hiding this comment.
Review summary
The independent agent completed its review for this commit.
Findings
src/content/docs/platform/oz-web-app.mdx(page-level, compression contract) — [SUGGESTION] The page is 1897 words (feature-doc budget: 1500) with 4 callouts (budget: 2); this predates the PR (already 1862 words/4 callouts on main) and this PR adds ~30 more words without addressing it. Requested resolution: file a follow-up trim pass on oz-web-app.mdx; not blocking for this cross-link-only PR.src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx:235— [NIT] "use session sharing to inspect cloud children for artifacts and session links" reads awkwardly ("inspect X for Y" implies searching X for evidence of Y). Requested resolution: reword to "use session sharing to inspect cloud children's artifacts and session links."src/content/docs/platform/viewing-cloud-agent-runs.mdx:27(PR body scope) — [SUGGESTION] The PR body's 'Pages touched / links added' section states this file gets links to Computer Use, Browser use, and Testing and recordings, but the diff only adds one link to the Computer Use index (/agents/capabilities/computer-use/) inline and in Related pages — no separate links to /agents/capabilities/computer-use/browser-use/ or /agents/capabilities/computer-use/testing-and-recordings/ landed. Requested resolution: either add the two more specific sibling links as originally planned, or correct the PR body to reflect the narrower scope actually shipped.
Verdict
Approve with nits
Reword 'inspect cloud children for artifacts and session links' to 'inspect cloud children's artifacts and session links' to avoid the 'inspect X for Y' misreading. Co-Authored-By: Warp <agent@warp.dev>
rachaelrenk
approved these changes
Sep 21, 2026
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
AEO brief
Goal: Identify small internal cross-link improvements for agents, cloud agents, and orchestration docs.
Recommendation: Update existing pages with high-confidence internal links. No new pages.
Source signals:
warp agent orchestration→/platform/orchestration/), cloud agents, multi-agent workflows, and computer use.*Docs should say: *Docs should say: *Docs should say: *Docs should say: *Docs should say: **Do, Warp Factories
Content scope:
Pages touched / links added:
src/content/docs/platform/viewing-cloud-agent-runs.mdx→ Computer Usesrc/content/docs/agents/capabilities/computer-use/index.mdx→ Viewing cloud agent runssrc/content/docs/platform/oz-web-app.mdx→ Viewing cloud agent runssrc/content/docs/agents/capabilities/slash-commands.mdx→ Multi-agent orchestration from/planOpen questions for human review:
oz-web-app.mdxis already over the feature-doc word/callout budget onmain(predates this PR); a follow-up trim pass is recommended but not part of this cross-link-only change.Summary
Adds five high-confidence internal cross-links (plus related-page and trailing-slash fixes) for agents, cloud agents, and orchestration docs based on Peec + GSC signals.
Documentation risk
Risk: low
Rationale: Cross-link-only edits to existing pages; no new product claims, commands, UI labels, or behavior descriptions.
Docs override: none
Unverified claims
VERIFYmarkers.