diff --git a/content/en/docs/refguide/mendix-ai-assistance/_index.md b/content/en/docs/refguide/mendix-ai-assistance/_index.md index 1870da51fbe..4389c0e0622 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/_index.md @@ -108,6 +108,7 @@ In Studio Pro 11.8 and above, [Maia Make](/refguide/maia-make/) replaces Maia Ch * **[Chat with Maia](/refguide/maia-chat/)** – Ask questions about app development in Mendix using Maia's chat feature, including how to apply concepts, best practices, and development patterns. * [Maia Learn](/refguide/maia-learn/) – Learn Mendix core concepts quickly to get started with Studio Pro. * [Maia Explain](/refguide/maia-explain/) – Maia Explain helps you understand existing documents, such as microflows and pages. It explains the general purpose of the document and highlights specific technical details. +* [Maia Plan Mode](/refguide/maia-plan-mode/) – Maia Plan Mode allows you to create detailed implementation plans for whole apps or large application features. ### Context and Customization diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md index b0f02d0d469..b1016d89b43 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md @@ -40,7 +40,7 @@ Maia Make can generate new documents, modify existing documents, and explain app | Enumerations | Studio Pro 11.9 | | | Constants | Studio Pro 11.9 | | | Modules | Studio Pro 11.9 | | -| Java actions | Studio Pro 11.9 | Read-only; Java actions cannot be generated. | +| Java actions | Studio Pro 11.9 | In Studio Pro 11.9 and above, Java actions are read-only and cannot be generated. In Studio Pro 11.16 and above, Java action documents and source code files can be generated and edited. | | JavaScript actions | Studio Pro 11.9 | Explain-only in Studio Pro 11.9. Generation, adding parameters, and updating the associated JavaScript file available from Studio Pro 11.10. | | Navigation | Studio Pro 11.11 | | | Menu | Studio Pro 11.11 | | @@ -48,6 +48,8 @@ Maia Make can generate new documents, modify existing documents, and explain app | JSON Structures | Studio Pro 11.13 | | | Change Data Capture | Studio Pro 11.14 | | | Task Queues | Studio Pro 11.15 | | +| Import Mappings | Studio Pro 11.16 | Maia can create import mappings with a JSON structure as the source and map them automatically to new entities. Changing existing import mappings is not supported. | +| Export Mappings | Studio Pro 11.16 | Maia can create export mappings with a JSON structure as the source and map them automatically to new entities. Changing existing export mappings is not supported. | ### Maia Make Standalone Capabilities @@ -62,6 +64,7 @@ The following table lists Maia Make Standalone Capabilities and the Studio Pro v | [Maia Web Fetch](/refguide/maia-web-fetch/) | Fetches and reads content from public websites and APIs. | Studio Pro 11.10 | | | [Maia Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/) | Extends Maia with reusable knowledge. | Studio Pro 11.11 | Maia can create and edit skills directly in chat, for both project-level and module-level skills, from Studio Pro 11.15. | | [Maia Agent Instructions (AGENTS.md)](/refguide/maia-agent-instructions/) | Extends Maia with instructions to be followed with every prompt | Studio Pro 11.12 | | +| [Maia Plan Mode](/refguide/maia-plan-mode/) | Allows Maia to maintain implementation plans. | Studio Pro 11.16 | | ### Maia Make General Capabilities @@ -70,16 +73,16 @@ The following table lists the general capabilities of Maia Make and the Studio P | Capability | Description | Available in Maia Make from | Remarks | | --- | --- | --- | --- | | Story-based development | Generates app artifacts based on existing user stories to support story-driven development workflows. | Studio Pro 11.8 | | -| PDF/image support | Allows you to provide PDFs and images as input to help Maia better understand your requirements. | Studio Pro 11.8 | | +| Attach files | Allows you to provide PDFs and images as input to help Maia better understand your requirements. | Studio Pro 11.8 | In Studio Pro 11.12 and above, you can attach Markdown files. In Studio Pro 11.16 and above, you can attach CSV, JSON, XML, YAML, and HTML files. Attached files are available to Maia for the rest of the session. | | Adding documents as context | Lets you add relevant documents to provide Maia with additional context. | Studio Pro 11.8 | | | Editing existing documents | Enables Maia to modify existing documents, including renaming elements. | Studio Pro 11.8 | | | Removing elements | Allows Maia to remove elements from documents to support more advanced refactoring tasks. | Studio Pro 11.9 | | | Undo support | Allows you to undo Maia-generated changes on a per-document basis. | Studio Pro 11.9 | | | Folder structure support | Organizes new documents into existing folders and follows your established folder hierarchy when generating content. | Studio Pro 11.10 | Not supported for pages. | | Themes and styling | Allows Maia to modify theme variables, create custom styling, and manage design properties. | Studio Pro 11.12 | | -| Markdown attachment support | Allows you to provide Markdown documents as input to help Maia better understand your requirements. | Studio Pro 11.12 | | | Explain and solve consistency errors | Allows you to use Maia to explain or solve problems by right-clicking the item in the **Errors** pane. | Studio Pro 11.12.1 | | | Translations | Allows Maia to create and update translations in your app. | Studio Pro 11.15 | | +| Delete documents | Allows Maia to delete documents in your app. | Studio Pro 11.16 | | ## Using Maia Make Capabilities @@ -109,7 +112,7 @@ Clicking **New Chat** allows you to clear the messages and start a new conversat #### Settings -The Settings option ({{% icon name="cog" %}}) allows you to manage your MCP Servers, agent skills, and export your Maia agent session. +The Settings option ({{% icon name="cog" %}}) allows you to manage your MCP Servers, agent skills, and export your Maia agent session. It also allows you to view and manage your tool permissions. You can configure permissions to **Always Allow** or allow only in the current session. {{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/maia-settings.jpg" width="250px" alt="" >}} diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md index a81c400f023..87f8233627e 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md @@ -23,7 +23,8 @@ For details on the current limitations, see the [Limitations](#limitations) sect There are two ways to open the MCP Client panel: -* Open the **Chat** tab in the **Maia** pane, then click **Configure MCP Connections** ({{% icon name="plug" %}}). +* Open the **Chat** tab in the **Maia** pane, then click **Settings** ({{% icon name="cog" %}}) > **MCP Servers***. + * For Studio Pro 11.14 and below, open the **Chat** tab in the **Maia** pane, then click **Configure MCP Connections** ({{% icon name="plug" %}}). * Go to the **View** menu and click **Maia Settings**. ### Preset Servers {#preset-servers} diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-plan-mode.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-plan-mode.md new file mode 100644 index 00000000000..a0c035ab1d5 --- /dev/null +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-plan-mode.md @@ -0,0 +1,61 @@ +--- +title: "Maia Plan Mode" +linktitle: "Plan Mode" +url: /refguide/maia-plan-mode/ +weight: 95 +description: "Describes how to use the planning features in Maia agent." +--- + +## Introduction + +{{% alert color="info" %}} +This feature is part of [Maia Make](/refguide/maia-make/) and was introduced in Studio Pro 11.16. + +To use Plan Mode, you need an internet connection and must be signed in to Studio Pro. This feature is not available when using the Studio Pro MCP server mode. Instead, you should use the native planning features of the agent that connects to Studio Pro. +{{% /alert %}} + +Maia Plan Mode helps you plan the implementation of an entire app or a large feature before making changes. Maia creates a plan that you can review and edit before starting implementation. + +You can also use the plan to track progress and continue implementation in a new chat session. + +## Creating a Plan + +When you ask Maia to implement an entire app or a large feature that spans several documents or modules, it asks whether you want to enter Plan Mode. + +If you agree, Maia reads the open app, gathers the context needed for your request, and writes an implementation plan. In Plan Mode, Maia can only read the open app and write a plan document. + +The plan is stored as a Markdown file in `maia/plans//plan.md` in your application directory. + +## Reviewing and Implementing a Plan + +After creating a plan, Maia asks you to review it. To review the plan and start implementation, follow these steps: + +1. In the **App Explorer**, expand **App** > **Maia** > **Plans** and select the plan. +2. Review the plan and make any necessary changes, either manually or by asking Maia. Save any manual changes before proceeding. +3. When you are satisfied with the plan, confirm Maia's request to exit Plan Mode and start implementation. + +## Tracking Progress + +The plan remains available in your application after Maia implements part or all of it. To pause implementation and continue in a new session, follow these steps: + +1. Stop Maia during implementation. +2. Ask Maia to record the progress made in the plan. +3. Start a new chat session and ask Maia to continue implementing the plan. + +## Manually Entering Plan Mode + +Maia's chat interface now includes the **Plan Mode** button, which you can click to enter Plan Mode manually. This signals to Maia that you are planning to implement a larger feature. While in Plan Mode, Maia can read your app and create an implementation plan. + +{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-plan-mode/maia-plan-mode.png" width="400" >}} + +## Limitations + +* Only Maia can create plans. You can edit a plan after Maia creates it. +* Maia cannot delete plans, so plans must be deleted manually. + +## Read More + +* [Maia Make Capabilities](/refguide/maia-make/) +* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) +* [Maia Chat](/refguide/maia-chat/) +* [AI-native SDLC Playbook](https://claude.com/resources/articles/the-ai-native-sdlc-playbook) \ No newline at end of file diff --git a/content/en/docs/refguide/modeling/menus/view-menu/_index.md b/content/en/docs/refguide/modeling/menus/view-menu/_index.md index d2bbdb6e360..693ceef4b69 100644 --- a/content/en/docs/refguide/modeling/menus/view-menu/_index.md +++ b/content/en/docs/refguide/modeling/menus/view-menu/_index.md @@ -123,9 +123,9 @@ For details on using Mendix Marketplace components in your app modeling, see [Ho In Studio Pro 11.14 and below, this tab is called **MCP Settings**. {{% /alert %}} -The **Maia Settings** pane allows you to connect Maia to External Model Context Protocol (MCP) servers. For Studio Pro 11.15 and above, this pane also stores [Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/). +The **Maia Settings** pane allows you to connect Maia to External Model Context Protocol (MCP) servers. For more information, see [Maia MCP Client](/refguide/maia-mcp/). -For more information, see [Maia MCP Client](/refguide/maia-mcp/). +For Studio Pro 11.15 and above, this pane also stores [Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/). For Studio Pro 11.16 and above, you can view and manage all tool permissions, such as Web Fetch and MCP Tools. ### OpenAPI Documentation {#api-documentation} diff --git a/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/maia-settings.jpg b/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/maia-settings.jpg index 7d9fd29922d..3fd7451e0bd 100644 Binary files a/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/maia-settings.jpg and b/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/maia-settings.jpg differ diff --git a/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-plan-mode/maia-plan-mode.png b/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-plan-mode/maia-plan-mode.png new file mode 100644 index 00000000000..419d27fc715 Binary files /dev/null and b/static/attachments/refguide/mendix-ai-assistance/maia-make/maia-plan-mode/maia-plan-mode.png differ