Skip to content

[REMOTE-2410] Teach oz-platform to fetch live Markdown docs - #14542

Merged
zachlloyd merged 3 commits into
masterfrom
factory/oz-platform-live-docs
Jul 30, 2026
Merged

[REMOTE-2410] Teach oz-platform to fetch live Markdown docs#14542
zachlloyd merged 3 commits into
masterfrom
factory/oz-platform-live-docs

Conversation

@warp-agent-staging

@warp-agent-staging warp-agent-staging Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Description

Teach the bundled oz-platform skill to consult current, authoritative documentation before relying on embedded examples:

  • document the agent-readable .md variant available for every docs.warp.dev page
  • point agents to llms.txt for documentation discovery
  • prefer live Markdown docs and installed CLI help for evolving platform behavior
  • update the existing CLI and API references to their Markdown variants

Linked Issue

REMOTE-2410

Testing

Testing-exempt category: pure documentation/skill copy. A regression test would only assert the new prose, so validation instead covered the skill content and every cited live source.

  • deterministic content check confirmed the .md, llms.txt, CLI help, and prefer-live-source guidance
  • git diff --check
  • verified llms.txt, computer-use.md, reference/cli.md, and reference/api-and-sdk.md return HTTP 200; all .md pages returned text/markdown
  • exact ./script/presubmit formatting/lint gate passed after refreshing from current master; the full integration suite could not complete in this cloud environment because unrelated tests require desktop/runtime services (XDG_RUNTIME_DIR, X11, SSH, and occupied test ports)

Rework changes

  • 🚨 Required Linux CI: reran the failed jobs in run 30569027126; Run Linux tests and Check CI results passed on attempt 2, confirming the untouched AddrInUse failure was transient. No oz-platform skill content changed during rework.
  • Refreshed the branch from current master through a conflict-free merge. Repository formatting, clippy, clang-format, and WGSL formatting passed; the full local nextest phase remains limited by unrelated cloud desktop/runtime failures already documented above.

Agent Mode

  • Warp Agent Mode - This PR was created via Warp's AI Agent Mode

Originating thread: https://warpdev.slack.com/archives/C0A27NDS7FB/p1785372012766299
Oz run: https://oz.staging.warp.dev/runs/019fb402-d71f-7085-9540-9bff0ba2554c

CHANGELOG-NONE

Co-Authored-By: Warp agent@warp.dev
Co-Authored-By: Oz oz-agent@warp.dev

Co-Authored-By: Warp <agent@warp.dev>

Co-Authored-By: Oz <oz-agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Jul 30, 2026
@warp-agent-staging
warp-agent-staging Bot requested a review from zachlloyd July 30, 2026 17:58
Co-Authored-By: Warp <agent@warp.dev>

Co-Authored-By: Oz <oz-agent@warp.dev>
@warp-agent-staging
warp-agent-staging Bot marked this pull request as ready for review July 30, 2026 18:07
@zachlloyd
zachlloyd enabled auto-merge (squash) July 30, 2026 18:35
Co-Authored-By: Oz <oz-agent@warp.dev>
@zachlloyd
zachlloyd merged commit 867347a into master Jul 30, 2026
31 checks passed
@zachlloyd
zachlloyd deleted the factory/oz-platform-live-docs branch July 30, 2026 20:59
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.

2 participants