Add Maia Maia Documentation

content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md

@@ -39,6 +39,16 @@ Mendix AI Assistance (Maia) in Studio Pro has the following capabilities:
 Starting point for app creation:
 
 * **Start with Maia** - a starting point in Studio Pro that helps you to start the app development process. Based on a required text description and an optional image or PDF, it generates an app that includes a domain model, data management overview pages, test data, and a tailored homepage. For more information, see [Start with Maia](/refguide/start-with-maia/).
+* **Maia Make** - a unified conversational UI in Studio Pro that consolidates all AI-assisted development capabilities into a single chat experience. With Maia Make, everything happens in one place. Start a conversation, describe what you need, and let Maia do the rest—generating a new domain model, overview pages, or microflows, or explaining your app logic and pages. Below is a list of Maia Make Capabilities:
+
+    * **Domain model creation** - Describe your data structure and Maia creates the entities and associations you need.
+    * **Page generation** - Generate overview pages.
+    * **Microflow generation** - Generate microflows, enumerations, XPath constraints, and expressions.
+    * **MCP client** - Connect to compatible MCP Servers to leverage tools such as Playwright or Figma to improve the capabilities of Maia.
+    * **Document upload** - Upload a PDF or an image and you can ask Maia to use it in your app creation. 
+    * **User story linking** - Select an existing story in Studio Pro and Maia can help you realize it. 
+
+    Maia Make is released in Studio Pro 11.8. For more information, see [Maia Make](/refguide/maia-make/).
 
 Guidance:
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-workflows.md

@@ -12,6 +12,10 @@ description: "Describes the features in Maia for Workflows."
 To use Maia for Workflows, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
+{{% alert color="info" %}}
+In Studio Pro 11.8, Maia for Workflows is not available.
+{{% /alert %}}
+
 Maia for Workflows helps you generate a [workflow](/refguide/workflows/). It can also provide explanations or further improvements based on the generated elements. The current version has some known limitations. For example, it is currently intended only for use with empty workflows. Generated elements are appended to the end of the workflow, which may result in incorrectly modeled workflows if the workflow is not empty. For more details, see the [Limitations](#limitation) section below.
 
 ## Using Maia for Workflows

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md

@@ -0,0 +1,68 @@
+---
+title: "Maia Make"
+url: /refguide/maia-make/
+weight: 4
+description: "Describes Maia Make capabilities in Mendix Studio Pro."
+description_list: true
+#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
+---
+
+## Introduction 
+
+{{% alert color="info" %}}
+Maia Make is available in Studio Pro 11.8 and above.
+
+To use Maia Make capabilities, an internet connection and signing in to Studio Pro are required.
+{{% /alert %}}
+
+Maia Make is a unified conversational interface in Studio Pro that brings AI-assisted development capabilities into a single chat window. Describe your requirements in natural language, and Maia Make generates development artifacts such as data structures, overview pages, and microflows. 
+
+You can also ask Maia Make to provide explanations of your existing logic and pages. Moreover, this interface allows you to integrate with external tools via MCP Servers (Playwright, Figma, and others) and it supports story-based development by aligning generated artifacts with user story acceptance criteria.
+
+The key capabilities of the Maia Make are as follows:
+
+* Conversational assistance for general Mendix development queries
+* Logic and page explanations to clarify existing implementation details
+* Domain model generation from natural language descriptions
+* Overview page generation from natural language descriptions
+* Microflow generation including XPath constraints and expressions
+* External tool integration via compatible MCP Servers (such as Playwright, Figma)
+* Story-based development to help realize existing user stories
+* PDF and image support to help Maia understand your requirements better
+* Add relevant logic and pages to the interface to give Maia a more desired context
+
+## Using Maia Make
+
+Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab.
+
+To access it, in the upper-right corner of Studio Pro, click the **Maia** pane:
+
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-make-interface.png" max-width=40% alt="Maia Make interface" >}}
+
+{{% todo %}}Update the screenshot when the latest build is available{{% /todo %}}
+
+Alternatively, you can also click **View** at the Studio Pro top bar and select **Maia** to open the interface.
+
+### Maia Make Interface Overview
+
+The Maia Make conversational interface includes the following options:
+
+* **New chat** - It allows you to clear the messages and start a new conversation which does not reference your current chat.
+* **Configure MCP Connections** ({{% icon name="plug" %}}) icon - It allows you to connect external [MCP](https://modelcontextprotocol.io/introduction) servers to Maia, giving it access to third-party tools during chat. For more information on how to configure MCP connections, see [Maia MCP Client](/refguide/maia-mcp/).
+* **Add** attachments (Image, Story, PDF) - With this option, you can attach images, PDFs, or user stories to help Maia understand your requirements better.
+* **Add to Maia Context** - It allows you to add certain logic or pages to Maia as context. You can also access this option by right-clicking the documents (microflows or pages) in the **App Explorer** and it appears in the context menu.
+
+For more information on how some of Maia key capabilities work, refer to the following documents:
+
+* [Maia Chat](/refguide/maia-chat/)
+* [Maia Explain](/refguide/maia-explain/)
+* [Maia for Domain Model](/refguide/maia-for-domain-model/)
+* [Maia for Pages](/refguide/maia-for-pages/)
+* [Maia for Microflows](/refguide/maia-for-microflows/)
+* [Maia MCP Client](/refguide/maia-mcp/)
+
+In Studio Pro 11.8 and above, most of the features described in the documents above are available only through the Maia Make interface. There are no separate entry points to these features in their respective editors. [Maia Explain](/refguide/maia-explain/) is an exception. You can still access this feature by right-clicking the documents (microflows or pages) in the **App Explorer** and the **Maia Explain** option is in the context menu.
+
+## Read More
+
+* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md → content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md

@@ -36,20 +36,26 @@ See below a list of Maia Chat's data sources:
 
 ## Using Maia Chat in Studio Pro
 
-There are two ways to access Maia Chat in Studio Pro:
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia Chat is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia Chat. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you.
+
+Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab.
+{{% /alert %}}
+
+In Studio Pro 11.7 and below, there are two ways to access Maia Chat in Studio Pro:
 
 * Click the **Maia** ({{% icon name="sparkles" %}}) icon to the right of the top bar.
 * Go to the **View** menu and click **Maia**.
 
 The chat interface appears at the right side of Studio Pro under the **Maia** pane:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png" width="250px">}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/maia-chat-interface.png" width="250px">}}
 
 You can start using Maia Chat by clicking one of the demo questions. Alternatively, you can ask your own question, and press <kbd>Enter</kbd> or click **Ask** to send the question. For information on the supported shortcut keys in Maia Chat, see the [Maia Chat Shortcut Keys](/refguide/keyboard-shortcuts/#maia-chat-shortcuts) section in *Keyboard Shortcuts*.
 
 For more information on Maia Chat features in Studio Pro, see the sub-sections below.
 
-If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can't get a good answer, please see [Giving Feedback](#feedback), below for information on how to let Mendix know.
+If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can not get a good answer, please see the [Giving Feedback](#feedback) section below for information on how to let Mendix know.
 
 ### Maia Chat Features in Studio Pro
 
@@ -72,7 +78,7 @@ There are several ways to give feedback on the generated answer:
 * Click the thumbs up icon ({{% icon name="thumbs-up" %}}) or the thumbs down icon ({{% icon name="thumbs-down" %}})
 * To provide more detailed feedback, click the add feedback icon ({{% icon name="notes-paper-edit" %}}). A detailed **Feedback** section shows below the answer:
 
-    {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}}
+    {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/feedback-section.png" width="250px" >}}
 
     * You can rate the **correctness**, **completeness**, and **readability** of the provided answer.
     * You can also provide **Additional feedback** if you want to.

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-explain.md → content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md

@@ -12,9 +12,15 @@ description: "Describes the features in Maia Explain."
 To use Maia Explain, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia Explain is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia Explain. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you.
+
+Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab.
+{{% /alert %}}
+
 Maia Explain helps you easily understand a microflow or a nanoflow. It explains the general purpose of the logic and highlights specific technical details to help you understand the logic further.
 
-## Using Maia Explain
+## Using Maia Explain in Studio Pro 11.7 and Below
 
 Maia Explain is enabled by default. If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia Explain** checkbox.
 
@@ -25,7 +31,7 @@ There are two ways to launch Maia Explain:
 
 A message is sent to Maia and a chat interface with an initial answer appears on the right side of Studio Pro under the **Maia** tab:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-explain/maia-explain-interface.png" width="300px">}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain/maia-explain-interface.png" width="300px">}}
 
 The initial answer consists of two parts: 
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-domain-model.md → content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md

@@ -18,11 +18,15 @@ Maia for Domain Model helps you generate new [domain model](/refguide/domain-mod
 
 ## Using Maia for Domain Model
 
-Maia for Domain Model is enabled by default.
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia for Domain Model is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia for Domain Model. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you.
+
+Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab.
+{{% /alert %}}
 
-You can find it in the the toolbar of a domain model:
+In Studio Pro 11.7 and below, Maia for Domain Model is enabled by default. You can find it in the the toolbar of a domain model:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/maia-for-domain-model.png" max-width=80% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/maia-for-domain-model.png" max-width=80% >}}
 
 If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia for Domain Model** checkbox.
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-microflows.md

@@ -0,0 +1,47 @@
+---
+title: "Maia for Microflows"
+url: /refguide/maia-for-microflows/
+weight: 75
+description: "Describes the features in Maia for Microflows."
+---
+## Introduction
+
+{{% alert color="info" %}}
+This feature is released as part of [Make Make](/refguide/maia-make/) capabilities in Studio Pro 11.8. 
+{{% /alert %}}
+
+Maia for Microflows is an AI-powered capability that is available when using [Maia Make](/refguide/maia-make/) in Studio Pro. Maia Make is a unified conversational interface within Studio Pro that consolidates all AI-assisted development capabilities into a single chat experience. 
+
+With the microflow generation capability, you can leverage Maia to generate microflow logic efficiently from your text input. It is a powerful tool for quickly setting up both simple and complex microflows, with the goal of providing ready-to-use logic that minimizes the need for manual adjustments.
+
+## Using Maia for Microflows
+
+Open the Maia Make conversational interface in Studio Pro to access its microflow generation capability. Use natural language to describe your goal, Maia will generate the microflows for you, including XPath constraints and expressions. See the section below for text input best practices.
+
+### Best Practices for Text Input
+
+To achieve the best results when using Maia to generate microflows, consider the following guidelines for your text input:
+
+* Be specific: Clearly describe the desired outcome and the steps involved. For example, instead of using *Create a user*, use *Create a new user object, set its name attribute to 'John Doe', and commit it*.
+* Use keywords: Incorporate terms relevant to microflow activities, such as *create object*, *retrieve*, *change object*, *show message*, *loop*, or *decision*. This can help with correct microflow generation.
+* Provide context: If your microflow interacts with existing entities or attributes, mention them in your text input.
+
+## Limitations
+
+### Destructive Operations Are Not Supported
+
+Maia for Microflows can create objects and flows and change simple ("primitive") settings, but it cannot delete objects or replace complex configuration settings. For example, for existing objects, Maia can change variable names, move objects, or reconnect flows, but it cannot delete objects or flows, or change the activity types.
+
+### Variability in Results
+
+Due to the nature of AI generation, the exact microflow logic produced can vary between separate runs, even with identical input. It is recommended to review the generated output carefully.
+
+### Layout and Positioning
+
+While Maia aims to create functional logic, the visual layout and positioning of elements within the generated microflow may not always be optimally organized. You may need to adjust the arrangement of activities for better readability and structure.
+
+## Read More
+
+* [Microflows](/refguide/microflows/)
+* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)
+* [Maia Chat](/refguide/maia-chat/)

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-pages.md → content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md

@@ -18,11 +18,17 @@ Maia for Pages helps you generate a [page](/refguide/page/) by adding and config
 
 ## Using Maia for Pages
 
-To enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**.
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia for Pages is incorporated into the unified [Maia Make](/refguide/maia-make/) interface. There is no dedicated interface only for Maia for Pages. With Maia Make, you can ask questions, ask Maia to explain your logic and pages, and let it generate development artifacts such as data structures, overview pages, and microflows for you.
+
+Maia Make is enabled by default. It is possible to disable it in Studio Pro **Preferences**, via the **Maia** tab.
+{{% /alert %}}
+
+In Studio Pro 11.7 and below, to enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**.
 
 Once enabled, you can find it in the the toolbar of a page:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/maia-for-pages.png" max-width=80% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/maia-for-pages.png" max-width=80% >}}
 
 {{% alert color="info" %}}
 Maia for Pages is available in both the **Structure mode** and **Design mode**.