Align Agent Platform docs and clarify AgentOS runtime

[ashpreetbedi]

Summary

• match all nine AgentOS Starter setup prompts to the template READMEs and invoke setup-platform from .agents/skills/
• document the current eight-skill workflow, including agent creation, eval authoring, review, and deployment
• align provider guides with the live templates for manifest registration, scheduled evals, JWT setup, prerequisites, and AWS region handling
• clarify AgentOS runtime, interface, API, and first-agent descriptions
• replace restart-safe durability claims with source-backed background execution and buffered reconnection wording
• update the scheduler example to OpenAIResponses(id="gpt-5.5")

Why

The setup prompt wording had drifted from the template READMEs. The docs now use the same minimal handoff as every Starter: clone the repository, enter it, and run the setup-platform skill in .agents/skills/. The skill owns the detailed setup sequence.

The AgentOS introduction also mixed explanation and reconnect how-to content while describing an in-process background task as durable. The revised page leads with a runnable AgentOS configuration, describes the supported surfaces directly, and links to the detailed background execution guide without promising restart-safe or lossless replay.

Validation

• executed the introduction configuration against the current Agno source in an isolated environment
• python3 scripts/inventory/run_all.py
• python3 scripts/check_install_coverage.py
• python3 scripts/check_imports.py from a clean worktree: 571 imports, 0 real failures
• python3 scripts/reference_drift.py
• mint broken-links
• mint validate
• git diff --check
• canonical setup-prompt and eight-skill contract comparison across all nine template repositories
• shell syntax checks across template scripts

Existing generator baseline

The linked Agno checkout is clean main at c7c5adcc60d1, package version 2.8.1, and is not on an exact tag.

• scripts/examples_sync/plan.py stops on the existing Valkey post-tag override.
• scripts/examples_sync/check_integrity.py reports 122 existing generated/source drift findings.

This PR does not modify generated example pages.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
agno	🟢 Ready	View Preview	Jul 23, 2026, 11:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.