Restructure modules into workflow groupings (step 1 of 2)

modules/ROOT/nav.adoc

@@ -1,86 +1,42 @@
-* 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]
-** 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:get-started:adp-overview.adoc[Quickstarts]
+** xref:get-started:byoc-quickstart.adoc[ADP Quickstart]
+** xref:get-started:gateway-quickstart.adoc[AI Gateway Quickstart]
+** xref:get-started:quickstart.adoc[AI Agent Quickstart]
+
+* xref:connect:index.adoc[Connect data & tools]
+** xref:connect:managed/managed-catalog.adoc[Plug in any app, database, or tool]
+** xref:connect:create-agent.adoc[Turn your data source into an agent]
+** xref:connect:create-server.adoc[Build a tool server for your own data]
+** xref:connect:register-remote.adoc[Connect a tool server you host yourself]
+** xref:connect:user-delegated-oauth.adoc[Let agents act as the signed-in user]
+** xref:connect:byoa-register.adoc[Register your own agent (BYOA)]
+** xref:connect:claude-code.adoc[Claude Code]
+** xref:connect:remote-mcp-clients.adoc[Remote MCP clients]
+
+* xref:monitor:index.adoc[Monitor & debug]
+** xref:monitor:transcripts.adoc[See what your agent did]
+** xref:monitor:troubleshoot-ai-agents.adoc[Investigate a broken run]
+** xref:monitor:metrics.adoc[Check speed, cost, and errors]
+** xref:control:guardrails/violations.adoc[Review blocked requests]
+** xref:monitor:byoa-telemetry.adoc[Send telemetry from agents you host]
+
+* xref:control:index.adoc[Control & govern]
+** xref:control:dashboard/overview.adoc[See all your agents in one place]
+** xref:control:guardrails/overview.adoc[Fix agents calling things they shouldn't]
+** xref:control:guardrails/create-guardrail.adoc[Set safety rules for all agents]
+** xref:control:budgets.adoc[Set spending limits]
+** xref:control:permissions-overview.adoc[Control who can do what]
+
+* xref:gateway:index.adoc[Routing & LLM settings]
+** xref:gateway:overview.adoc[How the gateway works]
+** xref:gateway:configure-provider.adoc[Configure LLM provider]
+*** xref:gateway:bedrock-setup.adoc[Set up AWS Bedrock]
+
+* xref:reference:index.adoc[Settings reference]
+** xref:control:permissions-reference.adoc[Roles and permissions matrix]
+** xref:control:guardrails/types-reference.adoc[Safety rule providers]
+** xref:reference:rpk-install.adoc[Install rpk]
+** xref:reference:rpk/index.adoc[rpk command reference]
 *** 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[]