From f73566598ecc04e48664287ad7d6388d028fb326 Mon Sep 17 00:00:00 2001
From: technical-writer <technical-writer@agents.moleculesai.app>
Date: Tue, 2 Jun 2026 10:34:31 -0700
Subject: [PATCH] docs(nav): surface Guides, Tutorials, Agent Runtime & API
 Protocol in the sidebar
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

80 of 125 pages were built + in the sitemap but absent from the sidebar — incl.
ALL 16 guides and ALL 9 tutorials — so users browsing the docs couldn't find
them (only reachable via search/inline links).

Added curated nav sections via folder meta.json + root-meta wiring:
- Guides (16): external-agent-registration, external-workspace-quickstart,
  remote-workspaces(+FAQ), claude-code-channel-plugin, mcp-server-setup,
  skill-catalog, token-management, org-api-keys, … (folder index = landing)
- Tutorials (9): google-adk-runtime, hermes-multi-provider-dispatch,
  register-remote-agent, self-hosted-workspace-docker, lark-feishu-channel,
  saas-federation, aws-ec2/fly-machines provisioner, saas-file-writes-eic
- Agent Runtime (9): cli-runtime, config-format, skills, agent-card,
  system-prompt-structure, team-expansion, bundle-system, social-channels,
  workspace-runtime
- API Protocol (5): a2a-protocol, communication-rules, registry-and-heartbeat,
  platform-api, websocket-events

Root nav gains '---Guides & Tutorials---' and '---Runtime & Protocol---' dividers.
Orphan-from-nav pages: 80 → 41 (the remaining 41 are intentional internal/deep
docs — ADRs, research evals, migration notes, incident log, smoke-test logs,
architecture internals — still public + in sitemap, just not in the user nav).

Full-doc link scan: 0 broken. Build green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 content/docs/agent-runtime/meta.json | 14 ++++++++++++++
 content/docs/api-protocol/meta.json  | 10 ++++++++++
 content/docs/guides/meta.json        | 21 +++++++++++++++++++++
 content/docs/meta.json               |  6 ++++++
 content/docs/tutorials/meta.json     | 14 ++++++++++++++
 5 files changed, 65 insertions(+)
 create mode 100644 content/docs/agent-runtime/meta.json
 create mode 100644 content/docs/api-protocol/meta.json
 create mode 100644 content/docs/guides/meta.json
 create mode 100644 content/docs/tutorials/meta.json

diff --git a/content/docs/agent-runtime/meta.json b/content/docs/agent-runtime/meta.json
new file mode 100644
index 0000000..c9aa0aa
--- /dev/null
+++ b/content/docs/agent-runtime/meta.json
@@ -0,0 +1,14 @@
+{
+  "title": "Agent Runtime",
+  "pages": [
+    "cli-runtime",
+    "config-format",
+    "skills",
+    "agent-card",
+    "system-prompt-structure",
+    "team-expansion",
+    "bundle-system",
+    "social-channels",
+    "workspace-runtime"
+  ]
+}
diff --git a/content/docs/api-protocol/meta.json b/content/docs/api-protocol/meta.json
new file mode 100644
index 0000000..2b57d47
--- /dev/null
+++ b/content/docs/api-protocol/meta.json
@@ -0,0 +1,10 @@
+{
+  "title": "API Protocol",
+  "pages": [
+    "a2a-protocol",
+    "communication-rules",
+    "registry-and-heartbeat",
+    "platform-api",
+    "websocket-events"
+  ]
+}
diff --git a/content/docs/guides/meta.json b/content/docs/guides/meta.json
new file mode 100644
index 0000000..b9330f5
--- /dev/null
+++ b/content/docs/guides/meta.json
@@ -0,0 +1,21 @@
+{
+  "title": "Guides",
+  "pages": [
+    "index",
+    "external-workspace-quickstart",
+    "external-agent-registration",
+    "remote-workspaces",
+    "remote-workspaces-faq",
+    "claude-code-channel-plugin",
+    "mcp-server-setup",
+    "chrome-devtools-mcp-setup",
+    "skill-catalog",
+    "token-management",
+    "org-api-keys",
+    "platform-instructions",
+    "molecli-shell-completion",
+    "tool-trace",
+    "same-origin-canvas-fetches",
+    "quickstart-audio"
+  ]
+}
diff --git a/content/docs/meta.json b/content/docs/meta.json
index 8e00e20..8810fc6 100644
--- a/content/docs/meta.json
+++ b/content/docs/meta.json
@@ -20,6 +20,12 @@
     "self-hosting",
     "observability",
     "troubleshooting",
+    "---Guides & Tutorials---",
+    "guides",
+    "tutorials",
+    "---Runtime & Protocol---",
+    "agent-runtime",
+    "api-protocol",
     "---Security---",
     "security/index",
     "security/safe-mcp-advisory",
diff --git a/content/docs/tutorials/meta.json b/content/docs/tutorials/meta.json
new file mode 100644
index 0000000..2d708ce
--- /dev/null
+++ b/content/docs/tutorials/meta.json
@@ -0,0 +1,14 @@
+{
+  "title": "Tutorials",
+  "pages": [
+    "google-adk-runtime",
+    "hermes-multi-provider-dispatch",
+    "register-remote-agent",
+    "self-hosted-workspace-docker",
+    "lark-feishu-channel",
+    "saas-federation",
+    "aws-ec2-provisioner",
+    "fly-machines-provisioner",
+    "saas-file-writes-eic"
+  ]
+}
-- 
2.52.0