diff --git a/modules/ROOT/images/learning-map-vibes-agents.svg b/modules/ROOT/images/learning-map-vibes-agents.svg
new file mode 100644
index 000000000..82f277560
--- /dev/null
+++ b/modules/ROOT/images/learning-map-vibes-agents.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" viewBox="0 0 72 72" role="img" aria-label="Agent networks">
+  <rect width="72" height="72" rx="10" fill="#F3E5F5"/>
+  <path d="M36 14l10 6v12l-10 6-10-6V20z" fill="#8E24AA"/>
+  <path d="M52 36l10 6v12l-10 6-10-6V42z" fill="#AB47BC"/>
+  <path d="M20 36l10 6v12l-10 6-10-6V42z" fill="#7B1FA2"/>
+  <path d="M36 28v8M46 40l-8 4M26 40l8 4" stroke="#fff" stroke-width="2" stroke-linecap="round" opacity="0.85"/>
+</svg>
diff --git a/modules/ROOT/images/learning-map-vibes-design.svg b/modules/ROOT/images/learning-map-vibes-design.svg
new file mode 100644
index 000000000..ba5270fd1
--- /dev/null
+++ b/modules/ROOT/images/learning-map-vibes-design.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" viewBox="0 0 72 72" role="img" aria-label="Design APIs">
+  <rect width="72" height="72" rx="10" fill="#E8F5E9"/>
+  <rect x="18" y="16" width="36" height="44" rx="4" fill="#43A047"/>
+  <rect x="24" y="24" width="24" height="3" rx="1" fill="#fff" opacity="0.9"/>
+  <rect x="24" y="32" width="18" height="3" rx="1" fill="#fff" opacity="0.75"/>
+  <rect x="24" y="40" width="22" height="3" rx="1" fill="#fff" opacity="0.75"/>
+  <rect x="24" y="48" width="14" height="3" rx="1" fill="#fff" opacity="0.6"/>
+</svg>
diff --git a/modules/ROOT/images/learning-map-vibes-discover.svg b/modules/ROOT/images/learning-map-vibes-discover.svg
new file mode 100644
index 000000000..b6d9e38ec
--- /dev/null
+++ b/modules/ROOT/images/learning-map-vibes-discover.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" viewBox="0 0 72 72" role="img" aria-label="Discover assets">
+  <rect width="72" height="72" rx="10" fill="#ECEFF1"/>
+  <circle cx="30" cy="30" r="12" fill="none" stroke="#546E7A" stroke-width="4"/>
+  <path d="M39 39l14 14" stroke="#546E7A" stroke-width="4" stroke-linecap="round"/>
+  <circle cx="30" cy="30" r="5" fill="#78909C"/>
+</svg>
diff --git a/modules/ROOT/images/learning-map-vibes-integrate.svg b/modules/ROOT/images/learning-map-vibes-integrate.svg
new file mode 100644
index 000000000..b84139303
--- /dev/null
+++ b/modules/ROOT/images/learning-map-vibes-integrate.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" viewBox="0 0 72 72" role="img" aria-label="Integrate">
+  <rect width="72" height="72" rx="10" fill="#FFF3E0"/>
+  <circle cx="22" cy="36" r="10" fill="#F57C00"/>
+  <circle cx="50" cy="22" r="10" fill="#FB8C00"/>
+  <circle cx="50" cy="50" r="10" fill="#EF6C00"/>
+  <path d="M30 34l12-8M30 38l12 8M40 28l8 4M40 44l8-4" stroke="#fff" stroke-width="2.5" stroke-linecap="round"/>
+</svg>
diff --git a/modules/ROOT/images/learning-map-vibes-operate.svg b/modules/ROOT/images/learning-map-vibes-operate.svg
new file mode 100644
index 000000000..31b9adf77
--- /dev/null
+++ b/modules/ROOT/images/learning-map-vibes-operate.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" viewBox="0 0 72 72" role="img" aria-label="Deploy and secure">
+  <rect width="72" height="72" rx="10" fill="#E8EAF6"/>
+  <path d="M36 12l18 10v28l-18 10-18-10V22z" fill="none" stroke="#3949AB" stroke-width="3"/>
+  <path d="M36 22v28M28 32l8-6 8 6" stroke="#5C6BC0" stroke-width="3" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+  <rect x="24" y="46" width="24" height="10" rx="2" fill="#3949AB"/>
+</svg>
diff --git a/modules/ROOT/images/learning-map-vibes-start.svg b/modules/ROOT/images/learning-map-vibes-start.svg
new file mode 100644
index 000000000..8f3daa24d
--- /dev/null
+++ b/modules/ROOT/images/learning-map-vibes-start.svg
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="72" height="72" viewBox="0 0 72 72" role="img" aria-label="Get started">
+  <rect width="72" height="72" rx="10" fill="#E3F2FD"/>
+  <circle cx="36" cy="34" r="16" fill="#039BE5"/>
+  <path d="M36 24v20M26 34h20" stroke="#fff" stroke-width="3" stroke-linecap="round"/>
+  <circle cx="52" cy="18" r="4" fill="#FFB300"/>
+</svg>
diff --git a/modules/ROOT/pages/learning-map-mulesoft-vibes.adoc b/modules/ROOT/pages/learning-map-mulesoft-vibes.adoc
new file mode 100644
index 000000000..321a0e539
--- /dev/null
+++ b/modules/ROOT/pages/learning-map-mulesoft-vibes.adoc
@@ -0,0 +1,72 @@
+= MuleSoft Vibes Learning Map for Anypoint Code Builder
+:page-deployment-options: cloud-ide, desktop-ide
+
+MuleSoft Vibes is the natural-language assistant in Anypoint Code Builder for API specifications, integrations, and related tasks through optional MCP servers. Use this map to open MuleSoft Vibes topics in the order that matches your goal, from first launch through customization, generation, and troubleshooting.
+
+The end-to-end journey with MuleSoft Vibes links to documentation that helps you complete that job inside Anypoint Code Builder.
+
+[cols="3*",frame=none,grid=none]
+|===
+a|
+image::learning-map-vibes-start.svg[Get started with MuleSoft Vibes,72,72]
+
+*Get Started with MuleSoft Vibes*
+
+Confirm prerequisites, open the assistant, and understand how MuleSoft Vibes plans and executes work in your workspace.
+
+* xref:mulesoft-vibes.adoc[]
+* xref:vibes-get-started.adoc[]
+
+a|
+image::learning-map-vibes-discover.svg[Review checkpoints and conversation history,72,72]
+
+*Review Checkpoints and Conversation History*
+
+Save and restore project states from MuleSoft Vibes, and return to earlier prompts and responses when you need to iterate or undo.
+
+* xref:vibes-checkpoints.adoc[]
+* xref:vibes-conversation-history.adoc[]
+
+a|
+image::learning-map-vibes-integrate.svg[Apply workflows and rules,72,72]
+
+*Apply Workflows and Rules*
+
+Shape how MuleSoft Vibes behaves in your workspace with rules and workflows so generated output stays consistent with your standards.
+
+* xref:vibes-workflows-commands.adoc[]
+
+a|
+image::learning-map-vibes-design.svg[Create API specifications,72,72]
+
+*Create API Specifications*
+
+Describe the API you want in natural language and use MuleSoft Vibes to produce and iterate on the specification in your project.
+
+* xref:vibes-api-ai-create-spec.adoc[]
+
+a|
+image::learning-map-vibes-agents.svg[Create Mule integrations,72,72]
+
+*Create Mule Integrations*
+
+Use prompts to generate runnable integration projects, including connector configuration and supporting artifacts, directly from MuleSoft Vibes.
+
+* xref:vibes-create-integrations.adoc[]
+
+a|
+image::learning-map-vibes-operate.svg[Configure MCP servers, prompts, and troubleshooting,72,72]
+
+*Configure MCP Servers, Example Prompts, and Troubleshooting*
+
+Add or manage MCP servers in the MuleSoft Vibes panel, copy proven prompt patterns, and resolve common generative AI issues.
+
+* xref:vibes-mcp-server.adoc[]
+* xref:vibes-prompt-examples.adoc[]
+* xref:troubleshoot-generative-ai.adoc[]
+
+|===
+
+== See Also
+
+* xref:mulesoft-vibes.adoc[]