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

modules/ROOT/pages/learning-map-mulesoft-vibes.adoc

@@ -0,0 +1,80 @@
+= MuleSoft Vibes for Anypoint Code Builder
+:page-article-style: learning-map
+
+MuleSoft Vibes is the natural-language assistant in Anypoint Code Builder for API specifications, integrations, and related tasks through optional MCP servers. Use the columns in order for a typical journey from discovery through design, build, session recovery and prompting, to MCP configuration—or jump to the section that matches your goal.
+
+[.lm-table, cols="1a,1a,1a", grid="none"]
+|===
+| image::reuse::lm_start.png[Learn about MuleSoft Vibes]
+
+[.lm-bold]##Learn About MuleSoft Vibes##
+
+MuleSoft Vibes is a purpose-built assistant for the development lifecycle, available directly in Anypoint Code Builder. Build, deploy, and manage your projects using natural language prompts.
+
+- xref:mulesoft-vibes.adoc#capabilities[Understand capabilities in your workspace]
+- xref:mulesoft-vibes.adoc#related-ai[Compare with broader MuleSoft AI in related resources]
+- xref:mulesoft-mcp-server::index.adoc[Review MuleSoft MCP Server]
+- xref:vibes-checkpoints.adoc[Track workspace changes with checkpoints]
+- xref:vibes-conversation-history.adoc#browse-conversation-history[Browse conversation history]
+
+| image::reuse::lm_analyze_1.png[Get started with MuleSoft Vibes]
+
+[.lm-bold]##Get Started##
+
+Set up the IDE, confirm permissions, then open MuleSoft Vibes and start prompting with confidence.
+
+- xref:start-acb.adoc[Set up and access the web or desktop IDE]
+- xref:start-configure-permissions.adoc#permissions[Configure Anypoint Code Builder permissions]
+- xref:vibes-get-started.adoc#use-mulesoft-vibes[Use MuleSoft Vibes]
+
+| image::reuse::lm_develop_1.png[Design APIs, rules, and automation]
+
+[.lm-bold]##Design APIs, Rules, and Automation##
+
+Shape API specs with AI, attach context, tune Vibes settings, and standardize output with rules, workflows, and commands.
+
+- xref:vibes-api-ai-create-spec.adoc#design-spec-ai[Generate and refine specs]
+- xref:vibes-api-ai-create-spec.adoc#rules-workflows[Define rules and workflows]
+- xref:vibes-api-ai-create-spec.adoc#context-files[Attach requirements and outputs]
+- xref:vibes-api-ai-create-spec.adoc#settings[Control confirmations and file access]
+- xref:vibes-workflows-commands.adoc#add-workflows-or-rules[Add workflows and rules]
+- xref:vibes-workflows-commands.adoc#add-commands[Invoke slash shortcuts]
+
+| image::reuse::lm_build_1.png[Build integration projects]
+
+[.lm-bold]##Build Integration Projects##
+
+Attach context to MuleSoft Vibes, open the assistant for integrations, and scaffold an integration project.
+
+- xref:vibes-get-started.adoc#provide-mulesoft-vibes-with-context[Attach folders and files]
+- xref:vibes-create-integrations.adoc#access-dev-agent[Open the assistant for creating integrations]
+- xref:vibes-create-integrations.adoc#create-integration-project[Scaffold a project]
+
+| image::reuse::lm_code_1.png[Resume work, prompt, and improve output]
+
+[.lm-bold]##Resume Work, Prompt, and Improve Output##
+
+Pick up tasks from conversation history, write and verify prompts, reuse example patterns, and improve output when results are inconsistent.
+
+- xref:vibes-conversation-history.adoc#browse-conversation-history[Reopen tasks from browse conversation history]
+- xref:troubleshoot-generative-ai.adoc#_unexpected_results_when_using_mulesoft_vibes[Improve inconsistent output]
+- xref:vibes-create-integrations.adoc#craft-ai-prompt[Write your prompt]
+- xref:vibes-create-integrations.adoc#complete-gen-flow[Apply and verify results]
+- xref:vibes-prompt-examples.adoc#_order_management[Use example prompts]
+
+| image::reuse::lm_integrate_1.png[Configure and manage MCP servers]
+
+[.lm-bold]##Configure and Manage MCP Servers##
+
+Install and tune MCP servers so MuleSoft Vibes can call the right tools with the right approvals.
+
+- xref:vibes-mcp-server.adoc[Configure MCP server]
+- xref:vibes-mcp-server.adoc#add-an-mcp-server[Add an MCP server]
+- xref:vibes-mcp-server.adoc#add-and-manage-custom-mcp-servers[Add and manage custom MCP servers]
+
+|===
+
+== See Also
+
+* xref:index.adoc[]
+* xref:mulesoft-vibes.adoc[]

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
 
 These features are powered by large language models (LLMs) that 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[Learning Map: MuleSoft AI].
+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, 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
 
 Before using MuleSoft Vibes, make sure that you meet these prerequisites:
@@ -35,13 +54,14 @@ Before using MuleSoft Vibes, make sure that you meet these prerequisites:
 * Ensure you have the following permissions to use MuleSoft Vibes:  
 ** *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 using natural language prompts directly in your development environment.
 
+[[use-mulesoft-vibes]]
 == Use MuleSoft Vibes
 
 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:
@@ -30,8 +32,8 @@ MuleSoft Vibes attempts to perform the actions outlined in the plan by using the
 
 You can switch between modes depending on whether you prefer to review the plan before execution or allow MuleSoft Vibes to act directly.
 
-
-=== How MuleSoft Vibes Generates Code
+[[how-mulesoft-vibes-generates-code]]
+=== Code Generation in MuleSoft Vibes
 
 MuleSoft Vibes uses MuleSoft-optimized AI pipelines to generate high-quality code for API specifications and integration flows.
 
@@ -50,7 +52,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.  
@@ -66,6 +68,7 @@ You can also add context directly from the prompt input box by typing `@`, which
 
 These inputs are used as contextual references during generation.
 
+[[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.

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.