W-21832961-MuleSoft-Vibes-learning-map-CP

modules/ROOT/pages/mulesoft-vibes.adoc

@@ -1,5 +1,5 @@
 = MuleSoft Vibes Overview
-:page-aliases: api-ai-design-spec.adoc
+:page-aliases: api-ai-design-spec.adoc, learn-about-mulesoft-vibes.adoc
 :page-deployment-options: cloud-ide, desktop-ide
 
 MuleSoft Vibes is a purpose-built assistant for the development lifecycle, available directly in Anypoint Code Builder.
@@ -22,10 +22,29 @@ You can also use xref:vibes-skills.adoc[skills], reusable instruction sets that
 
 Large language models (LLMs) power these features and operate within the Salesforce Shared Trust Boundary.
 
-MuleSoft Vibes is part of the broader MuleSoft AI ecosystem, which also includes capabilities such as Map with AI and Map and Transform with AI. For an overview of all MuleSoft AI features, see the xref:general::learning-map-mulesoft-ai.adoc[].
+MuleSoft Vibes is part of the broader MuleSoft AI ecosystem, which also includes capabilities such as Map with AI and Map and Transform with AI. For an overview of all MuleSoft AI features, see the xref:general::learning-map-mulesoft-ai.adoc[Learning Map: MuleSoft AI]. For a high-level overview that guides you through a curated set of MuleSoft Vibes topics in Anypoint Code Builder, see xref:learning-map-mulesoft-vibes.adoc[Learning Map: MuleSoft Vibes for Anypoint Code Builder].
 
 NOTE: MuleSoft Vibes is available on US, EU, Canada, and Japan cloud hosts.
 
+[[capabilities]]
+== Capabilities in Your Workspace
+
+MuleSoft Vibes helps you describe outcomes in plain language so the assistant can plan changes, generate artifacts, and run permitted actions against your connected MuleSoft environment. Generated work stays in your project and is subject to the same governance as code you write manually.
+
+Models run within the Salesforce Shared Trust Boundary, and the assistant inherits the permissions of the user signed in to Anypoint Code Builder. For supported regions, prerequisites, and a full capability list, see <<Before You Begin>>.
+
+[[mcp-integration]]
+== MCP Servers and Agentic Tools
+
+The MuleSoft MCP Server supplies tools that connect MuleSoft Vibes to Exchange, Runtime Manager, and other services so prompts can search assets, inspect deployments, and perform other allowed operations. You enable or restrict that behavior by which servers and tools you install.
+
+For product-level MCP documentation, see xref:mulesoft-mcp-server::index.adoc[]. When you are ready to add or tune servers inside the IDE, continue with xref:vibes-mcp-server.adoc[].
+
+[[related-ai]]
+== Related MuleSoft AI Resources
+
+MuleSoft Vibes is part of the broader MuleSoft AI story alongside experiences such as Map with AI and Map and Transform with AI. For a platform-wide learning path across those capabilities, see xref:general::learning-map-mulesoft-ai.adoc[].
+
 [[before-you-begin-vibes]]
 == Before You Begin
 
@@ -39,13 +58,14 @@ To use MuleSoft Vibes, make sure that you meet these prerequisites:
 * Ensure you have the following permissions:  
 ** *Anypoint Code Builder Developer* (to use MuleSoft Vibes in the Cloud IDE)  
 ** *Mule Developer Generative AI User*  
-* Make sure Einstein is enabled in Access Management. For more information, see xref:access-management::enabling-einstein.adoc[Enabling Einstein for Anypoint Platform].  
+* Make sure Einstein is enabled in Access Management. For more information, see xref:access-management::enabling-einstein.adoc[].  
 
 NOTE: Authentication happens through the user logged in to Anypoint Code Builder. MuleSoft Vibes inherits the same permissions as that user and can only execute actions that the user is authorized to perform in Anypoint Platform.
 
 == See Also
 
+* xref:vibes-get-started.adoc[]
 * xref:vibes-skills.adoc[]
 * xref:troubleshoot-generative-ai.adoc[]
 * xref:mulesoft-mcp-server::index.adoc[]
-* xref:int-manage-custom-metadata.adoc#custom-metadata-vibes[Custom metadata in MuleSoft Vibes]
+* xref:learning-map-mulesoft-vibes.adoc[]

modules/ROOT/pages/vibes-conversation-history.adoc

@@ -2,6 +2,7 @@
 
 MuleSoft Vibes allows you to return to tasks you have previously started and continue working from where you left off.
 
+[[browse-conversation-history]]
 To open a recently started task:
 
 . In the MuleSoft Vibes panel, locate the *Recent Tasks* section.
@@ -26,7 +27,7 @@ You can also filter tasks by:
 
 To favorite a task, click the *Star* icon next to the task entry.
 
-
+[[delete-history]]
 == Delete History
 
 You can remove past tasks in two ways:

modules/ROOT/pages/vibes-get-started.adoc

@@ -3,6 +3,7 @@
 
 MuleSoft Vibes helps you build APIs and integrations by sending natural language messages directly in your development environment.
 
+[[use-mulesoft-vibes]]
 == Use MuleSoft Vibes
 
 Ensure you meet the xref:mulesoft-vibes.adoc#before-you-begin-vibes[prerequisites] before you begin. You can open MuleSoft Vibes from the:
@@ -18,6 +19,7 @@ Depending on your configuration, MuleSoft Vibes can:
 * Request approval before writing to your files
 * Write automatically if *Auto-approve* is enabled in settings
 
+[[plan-and-act-modes]]
 === Plan and Act Modes
 
 MuleSoft Vibes operates in two modes:
@@ -46,8 +48,8 @@ Descriptions are generated on demand with your approval, which helps you documen
 
 If you prefer the previous experience, you can switch back to the *Classic* canvas view at any time from canvas controls or Anypoint Code Builder settings.
 
-
-=== How MuleSoft Vibes Generates Code
+[[how-mulesoft-vibes-generates-code]]
+=== Generate Code in MuleSoft Vibes
 
 MuleSoft Vibes uses MuleSoft-optimized AI pipelines to generate high-quality code for API specifications and integration flows.
 
@@ -66,6 +68,7 @@ To ensure the best results:
 
 For more information about how MuleSoft AI generation pipelines work, see the https://blogs.mulesoft.com/automation/how-mulesoft-turns-generative-output-into-value/[MuleSoft research blog].
 
+[[provide-mulesoft-vibes-with-context]]
 == Provide MuleSoft Vibes with Context
 
 You can improve the accuracy of MuleSoft Vibes output by providing additional context files or inputs.  
@@ -88,6 +91,7 @@ MuleSoft Vibes supports multi-modal context in the message area. Drag images dir
 
 Attach up to 10 files per conversation to help MuleSoft Vibes interpret requirements that are easier to explain through screenshots or supporting files.
 
+[[configure-mulesoft-vibes-settings]]
 == Configure MuleSoft Vibes Settings
 
 You can customize how MuleSoft Vibes interacts with your project through the *Settings* panel.  

modules/ROOT/pages/vibes-mcp-server.adoc

@@ -3,6 +3,7 @@
 
 Add and manage MCP servers in Anypoint Code Builder to extend MuleSoft Vibes with tools for API design, integrations, governance, and agent networks. 
 
+[[use-the-mulesoft-mcp-server]]
 == Use the MuleSoft MCP Server
 
 The MuleSoft MCP Server is integrated within Anypoint Code Builder and provides built-in tools to extend MuleSoft Vibes capabilities.
@@ -13,10 +14,12 @@ MuleSoft MCP Server tools are available in Anypoint Code Builder and are also su
 
 For more information about the MuleSoft MCP Server tools and their parameters, see: xref:mulesoft-mcp-server::reference-mcp-tools.adoc[MuleSoft MCP Server Tool Reference].
 
+[[add-and-manage-custom-mcp-servers]]
 == Add and Manage Custom MCP Servers
 
 From the MuleSoft Vibes panel, you can add your own MCP server or manage connected MCP servers through the MCP Server settings.
 
+[[open-mcp-server-settings]]
 == Open MCP Server Settings
 
 . Open the MuleSoft Vibes panel in Anypoint Code Builder.
@@ -67,7 +70,7 @@ If needed, you can configure MCP servers directly by editing the `a4d_mcp_settin
 Once an MCP server has been installed, you can manage it from the *Installed* tab.
 
 
-== Enable, Disable, or Restart Servers
+== Turn Servers On and Off
 
 . Select the *Installed* tab.
 . Toggle each MCP server on or off.
@@ -100,4 +103,7 @@ To remove an MCP server:
 . Select *Delete Server*.
 . Confirm the deletion.
 
+[NOTE]
+You can delete custom MCP servers that you add. The MuleSoft MCP Server is pre-installed with MuleSoft Vibes and can be turned on or off, but it can't be removed.
+
 Tool availability, behavior, and stability may vary depending on the MCP server version and configuration, as well as whether the server is community-provided or supported by Salesforce.

modules/ROOT/pages/vibes-workflows-commands.adoc

@@ -18,6 +18,7 @@ Workflows create predefined multi-step tasks that MuleSoft Vibes executes automa
 
 Workflows let you streamline repeated development steps and can be triggered using slash commands (for example, `/workflow-name`) in the Mulesoft Vibes panel.
 
+[[add-workflows-or-rules]]
 == Add Workflows or Rules
 
 . Open MuleSoft Mulesoft Vibes in the sidebar.
@@ -31,7 +32,8 @@ Workflows let you streamline repeated development steps and can be triggered usi
 
 You can edit or delete existing rules and workflows from the same section.
 
-=== Rule examples
+[[rule-examples]]
+=== Rule Examples
 
 You can use rules to guide how Mulesoft Vibes generates or validates content. For example:
 
@@ -51,6 +53,7 @@ Workflows define a sequence of steps that Mulesoft Vibes executes to complete a
 
 * *Troubleshooting workflow*: Analyze an error, identify the root cause, propose a fix, and update the configuration if needed.
 
+[[add-commands]]
 == Add Commands
 
 Commands provide quick shortcuts for interacting with Mulesoft Vibes.