Improve SDK, AgentOS, and Templates developer journeys

[ashpreetbedi]

Summary

This PR improves the developer journey across the SDK, AgentOS, and Templates tabs.

The first commit rewrites seven primary entry pages. The second commit extends the same pass into 24 focused follow-on pages.

SDK

• Rewrites the Tools, Sessions, Memory, Context, Evals, and Tracing overviews.
• Leads with the product problem, the developer using the feature, and the reason to choose each pattern.
• Keeps working code close to the first decision a developer needs to make.
• Replaces long inventories with focused decision tables and links to dedicated guides.

AgentOS

• Strengthens the Runtime, REST API, custom FastAPI, Interfaces, and Tracing guides.
• Explains why platform teams use each surface before documenting the mechanics.
• Clarifies persistence, authorization, tracing destinations, route ownership, and API access patterns.
• Keeps Control Plane language centered on managing and monitoring AgentOS runtimes.

Templates

• Reframes Dash, Coda, Scout, and Context around the teams and jobs they serve.
• Updates all nine Starter introductions with provider-specific positioning.
• Corrects the Starter skill count to six and describes the coding-agent improvement workflow accurately.
• Leaves deployment procedures unchanged.

Scope

This PR changes 31 handwritten pages. It does not change navigation, security documentation, generated examples, reference pages, or deployment procedures.

Validation

• python3 scripts/inventory/run_all.py
• python3 scripts/check_install_coverage.py
• python3 scripts/check_imports.py against Agno v2.7.2
• python3 scripts/reference_drift.py
• python3 scripts/examples_sync/plan.py
• python3 scripts/examples_sync/check_integrity.py
• python3 scripts/make_openapi.py against Agno v2.7.2
• mint broken-links
• mint validate
• git diff --check
• Visual review of every changed route

All required checks pass.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
agno	🟢 Ready	View Preview	Jul 20, 2026, 2:26 AM

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