docs: add AEO cross-links for agents and orchestration - #691
Conversation
Link harness, factory dashboard, CLI reference, Agent Memory, and Codebase Context pages to multi-agent orchestration, harnesses, cloud handoff, and viewing cloud agent runs.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
This PR was generated with Warp. Comment |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Co-Authored-By: Warp <agent@warp.dev>
|
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}
There was a problem hiding this comment.
Overview
This PR adds AEO cross-links across agent and orchestration docs, and it updates the agent-doc review workflow/tooling to require actionable blocking findings. No approved spec context was provided, and the security pass did not find security-specific issues.
Concerns
- The published-review verification path can still accept a same-head review that lacks the new
blocking_findingsfield, so the new enforcement is incomplete. - The new workflow regression test relies on substring checks and can miss trigger drift.
Verdict
Found: 0 critical, 1 important, 1 suggestions
Request changes
Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
| blocking_count = int(signal.get("critical")) + int(signal.get("important")) | ||
| except (TypeError, ValueError): | ||
| blocking_count = 0 | ||
| findings = signal.get("blocking_findings") |
There was a problem hiding this comment.
_published_review_matches_signal check still accepts a GitHub review by comparing only the older pr/head/verdict/count fields. A same-head review missing blocking_findings can satisfy the final gate; include blocking_findings in that published-review comparison before accepting the review.
| cls.workflow = _WORKFLOW.read_text(encoding="utf-8") | ||
|
|
||
| def test_review_waits_until_a_draft_is_ready(self): | ||
| self.assertIn("ready_for_review", self.workflow) |
There was a problem hiding this comment.
💡 [SUGGESTION] This can pass if ready_for_review appears only in a comment. Parse the pull_request.types list or assert the exact trigger stanza so the regression test fails when the event is removed.
Co-Authored-By: Warp <agent@warp.dev>
1 participant
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 only (no new pages).
Source signals:
warp factory(499 clicks),warp agent cli(419),warp agent(258),warp remote control(147),warp cloud agents/cloud agents,warp harness, andwarp agent orchestration. Top combo landing pages include factories and remote-control docs./handofflacked the handoff guide link that/orchestratealready had; Agent Memory names harnesses without the harnesses hub; Codebase Context names cloud agent runs without the viewing-runs page.Vocabulary map:
Content scope:
Pages touched:
src/content/docs/platform/harnesses/warp-agent.mdx- Cross-harness parent/child behavior → multi-agent orchestration.src/content/docs/factories/factory-dashboard.mdx- Sub-agents tab on runs → multi-agent orchestration.src/content/docs/agents/cli/reference.mdx-/handoffslash command → cloud handoff and orchestration.src/content/docs/agents/agent-memory/index.mdx- Supported harnesses → harnesses overview.src/content/docs/agents/capabilities/codebase-context.mdx- Cloud agent runs section → viewing cloud agent runs.Links added:
/handoff→ /agents/cli/cloud-and-orchestration/#hand-off-to-a-cloud-agentReader next step:
/handoff.Open questions for human review:
Links added (this run)
platform/harnesses/warp-agent.mdx/platform/orchestration/factories/factory-dashboard.mdx/platform/orchestration/agents/cli/reference.mdx/agents/cli/cloud-and-orchestration/#hand-off-to-a-cloud-agent/orchestratedeep link.agents/agent-memory/index.mdx/platform/harnesses/agents/capabilities/codebase-context.mdx/platform/viewing-cloud-agent-runs/Documentation risk
Risk: low
Rationale: Cross-link-only changes to existing pages; descriptive internal links and minimal surrounding wording; no new product claims, commands, UI paths, or examples.
Docs override: none
Unverified claims
{/* VERIFY */}markers added.Oz run: https://app.warp.dev/conversation/2e55a2ca-745a-44ba-b579-00703a526637