From 492a8699c36ab3b9b5bb5ad2fee94f72bcd5b9ee Mon Sep 17 00:00:00 2001 From: Petar Vukmirovic Date: Mon, 19 Oct 2026 12:03:10 +0200 Subject: [PATCH 1/2] Introduce plan mode. --- .../refguide/mendix-ai-assistance/_index.md | 1 + .../mendix-ai-assistance/maia-make/_index.md | 1 + .../maia-make/maia-plan-mode.md | 64 +++++++++++++++++++ 3 files changed, 66 insertions(+) create mode 100644 content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-plan-mode.md diff --git a/content/en/docs/refguide/mendix-ai-assistance/_index.md b/content/en/docs/refguide/mendix-ai-assistance/_index.md index cc6cc37bb90..7fb3a0de091 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/_index.md @@ -60,6 +60,7 @@ Guidance: * **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. For more information, see [Maia Explain](/refguide/maia-explain/). * **Maia Agent Skills** – lets you define modular, reusable instructions that extend Maia with domain-specific knowledge. Maia applies them automatically whenever relevant, eliminating the need to repeat the same context across conversations. For more information, see [Maia Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/). * **Maia Agent Instructions** – allows you to define project- or module-level instructions (AGENTS.md) that steer agent behavior. You can use them to set common context for your prompts, such as company conventions or environment restrictions. For more information, see [Maia Agent Instructions (AGENTS.md)](/refguide/maia-agent-instructions/). +* **Maia Plan Mode** – allows you to create detailed plans of implementation for whole apps or large application features. For more information, see [Maia Plan Mode](/refguide/maia-plan-mode/). Recommenders: 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 90b5a950281..2dd3689de0a 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 @@ -60,6 +60,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 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..95dce63beb0 --- /dev/null +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-plan-mode.md @@ -0,0 +1,64 @@ +--- +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 (potentially using Maia) 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, Maia 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 a Markdown file stored at `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. Edit it yourself or ask Maia to make changes. +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 input box now contains the **Plan Mode** button. By pressing the **Plan Mode** button you can enter the plan mode manually. +This signals to Maia that you are planning to implement a larger feature and will allow Maia only to read the app and eventually +write a plan. + +## Limitations + +* Only Maia can create plans. You can edit a plan after Maia creates it. +* Maia cannot delete plans. You can delete them yourself. + +## Read More + +* [Maia Make Capabilities](/refguide/maia-make/) +* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) +* [Maia Chat](/refguide/maia-chat/) +* [AI SDLC playbook](https://claude.com/resources/articles/the-ai-native-sdlc-playbook) \ No newline at end of file From 2962a06f2bc9c32f9a57f5074166226e60d6af8e Mon Sep 17 00:00:00 2001 From: Petar Vukmirovic Date: Mon, 19 Oct 2026 13:10:10 +0200 Subject: [PATCH 2/2] Ensure manual changes are saved. --- .../refguide/mendix-ai-assistance/maia-make/maia-plan-mode.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 index 95dce63beb0..194d7873c22 100644 --- 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 @@ -32,7 +32,7 @@ The plan is a Markdown file stored at `maia/plans//plan.md` in your a 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. Edit it yourself or ask Maia to make changes. +2. Review the plan. Edit it yourself or ask Maia to make changes. Make sure any manual changes are saved. 3. When you are satisfied with the plan, confirm Maia's request to exit Plan Mode and start implementation. ## Tracking Progress