Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions content/en/docs/refguide/mendix-ai-assistance/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,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

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
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-name>/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

The Maia input box 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.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@petarvukmirovic By "Input box" do you mean the chat feature? And can you provide a screenshot of where this is in the UI?


## 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)
Loading