Reorganize ADP nav around job-to-be-done workflows

modules/ROOT/nav.adoc

@@ -1,131 +1,45 @@
-* xref:get-started:adp-overview.adoc[Overview]
-* xref:get-started:byoc-quickstart.adoc[ADP Quickstart]
-* xref:agents:index.adoc[Agents]
-** xref:agents:overview.adoc[Overview]
-** xref:agents:quickstart.adoc[AI Agent Quickstart]
-** xref:agents:concepts.adoc[Concepts]
-** xref:agents:a2a-concepts.adoc[Agent-to-Agent Concepts]
-** xref:agents:create-agent.adoc[Create a Declarative Agent]
-** xref:agents:byoa-register.adoc[Register Your Own Agent (BYOA)]
-** xref:agents:system-prompts.adoc[System Prompt Best Practices]
-** xref:agents:architecture-patterns.adoc[Architecture Patterns]
-** xref:agents:integration-overview.adoc[Integration Overview]
-** xref:agents:pipeline-integration-patterns.adoc[Pipeline Integration Patterns]
-** xref:agents:monitor.adoc[Monitor Agents]
-** xref:agents:troubleshoot/index.adoc[Troubleshoot]
-*** xref:agents:troubleshoot/troubleshoot-ai-agents.adoc[Troubleshoot AI Agents]
-*** xref:agents:tutorials/index.adoc[Tutorials]
-**** xref:agents:tutorials/customer-support-agent.adoc[Customer Support Agent]
-**** xref:agents:tutorials/transaction-dispute-resolution.adoc[Transaction Dispute Resolution]
-* xref:mcp:index.adoc[MCP Servers]
-** xref:mcp:overview.adoc[Overview]
-** xref:mcp:create-server.adoc[Create a Server]
-** xref:mcp:register-remote.adoc[Register a Self-Managed Server]
-** xref:mcp:oauth-providers.adoc[Configure an OAuth Provider]
-** xref:mcp:user-delegated-oauth.adoc[User-Delegated OAuth]
-*** xref:mcp:github-oauth-tutorial.adoc[Tutorial: Set Up GitHub OAuth]
-** xref:mcp:test-tools.adoc[Test a Server's Tools]
-** xref:mcp:managed/index.adoc[Managed Catalog]
-*** xref:mcp:managed/managed-catalog.adoc[Catalog Reference]
-*** xref:mcp:managed/bamboohr.adoc[BambooHR]
-*** xref:mcp:managed/sql.adoc[SQL]
-*** xref:mcp:managed/kafka.adoc[Kafka]
-*** xref:mcp:managed/slack.adoc[Slack]
-*** xref:mcp:managed/ironclad.adoc[Ironclad]
-*** xref:mcp:managed/jira.adoc[Jira]
-*** xref:mcp:managed/metabase.adoc[Metabase]
-*** xref:mcp:managed/netsuite.adoc[NetSuite]
-*** xref:mcp:managed/openapi.adoc[OpenAPI]
-*** xref:mcp:managed/ramp.adoc[Ramp]
-*** xref:mcp:managed/workday.adoc[Workday]
-*** xref:mcp:managed/zendesk.adoc[Zendesk]
-* xref:ai-gateway:index.adoc[AI Gateway]
-** xref:ai-gateway:overview.adoc[Overview]
+* Quickstarts
+** xref:get-started:byoc-quickstart.adoc[ADP Quickstart]
 ** xref:ai-gateway:gateway-quickstart.adoc[AI Gateway Quickstart]
-** xref:ai-gateway:gateway-architecture.adoc[Architecture]
-** xref:ai-gateway:configure-provider.adoc[Configure Your LLM Provider]
-*** xref:ai-gateway:bedrock-setup.adoc[Set Up AWS Bedrock]
-** xref:ai-gateway:aggregation.adoc[MCP Aggregation]
-** xref:ai-gateway:connect-agent.adoc[Connect Your Agent]
-*** xref:ai-gateway:admin/index.adoc[For Admins]
-**** xref:ai-gateway:admin/setup-guide.adoc[Setup Guide]
-*** xref:ai-gateway:builders/index.adoc[For Builders]
-**** xref:ai-gateway:builders/discover-gateways.adoc[Discover Gateways]
-* xref:governance:index.adoc[Governance]
-** xref:governance:dashboard/index.adoc[Governance Dashboard]
-*** xref:governance:dashboard/overview.adoc[Read the Governance Overview]
-** xref:governance:guardrails/index.adoc[Guardrails]
-*** xref:governance:guardrails/overview.adoc[Overview]
-*** xref:governance:guardrails/create-guardrail.adoc[Create a Guardrail]
-*** xref:governance:guardrails/types-reference.adoc[Evaluator Types]
-*** xref:governance:guardrails/violations.adoc[Read Violations]
-*** xref:governance:guardrails/cost-tracking.adoc[Cost Tracking]
-** xref:governance:budgets.adoc[Token Budgets and Limits]
-** xref:governance:kill-switch.adoc[Kill Switch]
-** xref:governance:permissions-overview.adoc[About ADP Permissions]
-** xref:governance:permissions-reference.adoc[ADP Permissions Reference]
-* xref:observability:index.adoc[Observability]
-** xref:observability:concepts.adoc[Concepts]
-** xref:observability:transcripts.adoc[Read a Transcript]
-** xref:observability:byoa-telemetry.adoc[BYOA Telemetry (OpenTelemetry)]
-** xref:observability:ingest-custom-traces.adoc[Ingest Custom Traces]
-** xref:observability:metrics.adoc[Metrics]
-** xref:observability:logs.adoc[Logs]
-* xref:integrations:index.adoc[Integrations]
-** xref:integrations:remote-mcp-clients.adoc[Remote MCP Clients]
-** xref:integrations:claude-code.adoc[Claude Code]
-** xref:integrations:cursor.adoc[Cursor]
-** xref:integrations:continue.adoc[Continue]
-** xref:integrations:cline.adoc[Cline]
-** xref:integrations:copilot.adoc[GitHub Copilot]
-* xref:reference:index.adoc[Reference]
-** xref:get-started:rpk-install.adoc[Install or Update rpk]
-** xref:reference:rpk/index.adoc[rpk Commands]
-*** xref:reference:rpk/rpk-ai/rpk-ai.adoc[rpk ai]
-**** xref:reference:rpk/rpk-ai/rpk-ai-agent.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-agent-list.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-connection.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-connection-list.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-connection-revoke.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-install.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-llm.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-llm-create.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-llm-delete.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-llm-get.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-llm-list.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-llm-update.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-mcp.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-create.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-delete.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-get.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-list.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-tools.adoc[]
-****** xref:reference:rpk/rpk-ai/rpk-ai-mcp-tools-call.adoc[]
-****** xref:reference:rpk/rpk-ai/rpk-ai-mcp-tools-list.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-types.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-mcp-update.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-model.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-model-get.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-model-list.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-oauth.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-create.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-delete.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-get.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-list.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-update.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-create.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-delete.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-get.adoc[]
-***** xref:reference:rpk/rpk-ai/rpk-ai-oauth-client-list.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-uninstall.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-upgrade.adoc[]
-**** xref:reference:rpk/rpk-ai/rpk-ai-version.adoc[]
-*** xref:reference:rpk/rpk-cloud/rpk-cloud.adoc[rpk cloud]
-**** xref:reference:rpk/rpk-cloud/rpk-cloud-login.adoc[]
-**** xref:reference:rpk/rpk-cloud/rpk-cloud-logout.adoc[]
-**** xref:reference:rpk/rpk-cloud/rpk-cloud-cluster.adoc[]
-***** xref:reference:rpk/rpk-cloud/rpk-cloud-cluster-select.adoc[]
-*** xref:reference:rpk/rpk-profile/rpk-profile.adoc[rpk profile]
-*** xref:reference:rpk/rpk-x-options.adoc[rpk -X]
+** xref:agents:quickstart.adoc[AI Agent Quickstart]
+
+* Connect data & tools
+** xref:mcp:managed/managed-catalog.adoc[Plug in any app, database, or tool]
+** xref:agents:create-agent.adoc[Turn your data source into an agent]
+** xref:mcp:create-server.adoc[Build a tool server for your own data]
+** xref:mcp:register-remote.adoc[Connect a tool server you host yourself]
+** xref:mcp:user-delegated-oauth.adoc[Let agents act as the signed-in user]
+
+* Monitor & debug
+** xref:observability:transcripts.adoc[See what your agent did]
+** xref:agents:troubleshoot/troubleshoot-ai-agents.adoc[Investigate a broken run]
+** xref:observability:metrics.adoc[Check speed, cost, and errors]
+** xref:governance:guardrails/violations.adoc[Review blocked requests]
+** xref:observability:byoa-telemetry.adoc[Send telemetry from agents you host]
+
+* Control & govern
+** xref:governance:dashboard/overview.adoc[See all your agents in one place]
+** xref:governance:guardrails/overview.adoc[Fix agents calling things they shouldn't]
+** xref:governance:guardrails/create-guardrail.adoc[Set safety rules for all agents]
+** xref:governance:budgets.adoc[Set spending limits]
+** xref:governance:permissions-overview.adoc[Control who can do what]
+
+* Routing & LLM settings
+** xref:ai-gateway:overview.adoc[How the gateway works]
+** xref:ai-gateway:configure-provider.adoc[Configure LLM provider]
+*** xref:ai-gateway:bedrock-setup.adoc[Set up AWS Bedrock]
+
+* Concepts
+** xref:agents:concepts.adoc[Agents, MCP servers, and data sources]
+** xref:ai-gateway:gateway-architecture.adoc[How the AI Gateway works]
+** xref:agents:byoa-register.adoc[Declarative vs. BYOA]
+** xref:governance:permissions-overview.adoc[How access control works]
+** xref:mcp:overview.adoc[What MCP servers expose]
+** xref:observability:concepts.adoc[How transcripts and traces work]
+
+* Settings reference
+** xref:governance:permissions-reference.adoc[Roles and permissions matrix]
+** xref:governance:guardrails/types-reference.adoc[Safety rule providers]
+** xref:get-started:rpk-install.adoc[Install rpk]
+** xref:reference:rpk/index.adoc[rpk command reference]
 ** xref:reference:glossary.adoc[Glossary]