diff --git a/content/pages/docs/zoo-design-studio/features/ml-ai/index.mdx b/content/pages/docs/zoo-design-studio/features/ml-ai/index.mdx
index ffe39d4a..349ea7ce 100644
--- a/content/pages/docs/zoo-design-studio/features/ml-ai/index.mdx
+++ b/content/pages/docs/zoo-design-studio/features/ml-ai/index.mdx
@@ -22,8 +22,11 @@ Most in-app ML and AI workflows route through
 there for the main user workflow around AI-assisted geometry creation, modification, and design
 reasoning.
 
-Zookeeper includes Auto, Standard, and Thoughtful modes. Available modes depend on your plan, and
-unavailable modes appear in the selector with upgrade messaging.
+## Modes
+
+[Modes](/docs/zoo-design-studio/features/ml-ai/modes) covers Auto, Standard, and Thoughtful modes,
+including how each mode balances reasoning depth and speed, and how plan availability affects the
+selector.
 
 ## Queue and Steer
 
diff --git a/content/pages/docs/zoo-design-studio/features/ml-ai/modes/index.mdx b/content/pages/docs/zoo-design-studio/features/ml-ai/modes/index.mdx
new file mode 100644
index 00000000..390f0532
--- /dev/null
+++ b/content/pages/docs/zoo-design-studio/features/ml-ai/modes/index.mdx
@@ -0,0 +1,70 @@
+---
+title: Modes
+excerpt: Choose between Auto, Standard, and Thoughtful modes in Zookeeper.
+sidebarPosition: 0
+---
+
+Zookeeper has three modes: Auto, Standard, and Thoughtful. Modes change how much reasoning
+Zookeeper applies before it responds. Use Auto when you want Zookeeper to choose for you, Standard
+for quick work, and Thoughtful for complex CAD tasks that benefit from deeper reasoning.
+
+<FramedImage
+  src="/documentation-assets/docs/zoo-design-studio/features/ml-ai/zookeeper-shaft-prompt.webp"
+  alt="Zoo Design Studio Zookeeper prompt field with a secondary shaft prompt"
+  aspect="992 / 622"
+  maxHeightPx={460}
+/>
+<div style={{textAlign: 'center', marginBottom: '1.5em', fontStyle: 'italic'}}>
+  Open the prompt controls to choose a mode before sending your request
+</div>
+
+## Auto
+
+Auto chooses the model and reasoning effort for the task. Start here when you want Zookeeper to
+balance speed, cost, and capability automatically.
+
+## Thoughtful
+
+Thoughtful takes more time, but gives Zookeeper more reasoning depth. Use it for complex CAD
+modeling, multi-step edits, and workflows where quality matters more than response speed.
+
+## Standard
+
+Standard prioritizes faster responses with less reasoning depth. Use it for simple geometry
+changes, quick iterations, web search, documentation lookup, or general questions about a design.
+
+## Availability
+
+Your plan determines which modes you can select. Modes that are not included in your plan still
+appear in the selector with upgrade messaging, so you can see what is available on paid plans.
+
+Free users can select Auto only. Paid plans include all three modes: Auto, Standard, and Thoughtful.
+
+### Free plan
+
+On the Free plan, Auto is selectable. Standard and Thoughtful stay visible but disabled until your
+plan includes them.
+
+<FramedImage
+  src="/documentation-assets/pages/zookeeper/zookeeper-mode-selector-free.png"
+  alt="Zookeeper mode selector for a Free user with Standard and Thoughtful unavailable and Auto selected"
+  aspect="359 / 454"
+  maxHeightPx={454}
+  className="max-w-sm mb-14"
+/>
+
+### Paid plans
+
+On paid plans, Auto, Standard, and Thoughtful are all selectable. Use Auto for automatic selection,
+Standard for speed, or Thoughtful for deeper CAD reasoning.
+
+<FramedImage
+  src="/documentation-assets/pages/zookeeper/zookeeper-mode-selector-paid.png"
+  alt="Zookeeper mode selector for a paid user with Standard, Thoughtful, and Auto available"
+  aspect="308 / 436"
+  maxHeightPx={436}
+  className="max-w-xs"
+/>
+
+For the full assistant workflow, see [Zookeeper](/docs/zoo-design-studio/zookeeper) and
+[AI Chat](/docs/zoo-design-studio/features/workspace/ai-chat).
diff --git a/content/pages/docs/zoo-design-studio/features/ml-ai/queue-and-steer/index.mdx b/content/pages/docs/zoo-design-studio/features/ml-ai/queue-and-steer/index.mdx
index b5078198..e05b9d6c 100644
--- a/content/pages/docs/zoo-design-studio/features/ml-ai/queue-and-steer/index.mdx
+++ b/content/pages/docs/zoo-design-studio/features/ml-ai/queue-and-steer/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Queue and Steer
 excerpt: Add follow-up prompts and redirect active Zookeeper work.
-sidebarPosition: 0
+sidebarPosition: 1
 ---
 
 Queue and Steer keeps AI Chat moving while Zookeeper is working. Queue captures the next prompt.
diff --git a/content/pages/docs/zoo-design-studio/features/ml-ai/zoodle/index.mdx b/content/pages/docs/zoo-design-studio/features/ml-ai/zoodle/index.mdx
index 2423ce68..057ea493 100644
--- a/content/pages/docs/zoo-design-studio/features/ml-ai/zoodle/index.mdx
+++ b/content/pages/docs/zoo-design-studio/features/ml-ai/zoodle/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Zoodle
 excerpt: Mark up the model viewport and send visual edit guidance to Zookeeper.
-sidebarPosition: 1
+sidebarPosition: 2
 ---
 
 Zoodle captures the current model viewport, lets you draw markup over it, and attaches that marked-up