Ask any Mendix developer what they would rather do: build a new feature or spend half a day documenting the last one – you already know the answer. Documentation may be less satisfying than coding, but that is not the only reason it keeps slipping down the backlog.
Under tight deadlines and the pressure to deliver working code, documentation is usually the first thing to fall by the wayside. What does get written is often informal, difficult to follow, and quickly becomes outdated. The more cluttered the existing documentation becomes, the less sense developers see in maintaining it – and the gap grows with every release.
What if documentation could keep itself up to date, scale with the application, and make every change traceable? For many teams, this would change more than just their daily routine. It would fundamentally shift their perspective on upgrading to Mendix 11.
The hidden costs of undocumented Mendix apps
Many Mendix applications have been in production for years, some even since Mendix 6 or 7, and many of them are business-critical. Upgrading to Mendix 11 should be a logical step. Instead, it often feels like a leap into the unknown.
When a large portion of app knowledge exists only in the heads of those involved, no one can say exactly what the application contains, what might break when changes are made, or how long the analysis will take. This presents teams with three dilemmas:
1. Upgrade now or continue building on an outdated foundation?
An upgrade means facing the legacy of years of changes: hidden workarounds, outdated widgets, and old modules that no one remembers. Furthermore, every major Mendix version leaves older widgets, modules, and Java versions behind. An upgrade therefore often means replacing parts of the app rather than just recompiling them. However, if you stick with the old version, every new feature is built on a foundation that becomes increasingly obsolete, while Mendix 11 features like Maia remain out of reach.
2. Move fast or maintain stability?
The business demands new features, more users, and new integrations. Without documentation, however, no one can predict the impact of a change. Without tests or a clear description of the desired process behavior, no one can confirm that everything still works afterward. Every release becomes a compromise between speed and stability, and scaling the app becomes more difficult each time.
3. Invest in the upgrade or in new features?
If you cannot determine the scope of an upgrade, you cannot budget for it. Every process must be checked manually, and the experienced developers who could answer the questions may no longer be on the team. Faced with unclear costs and a functioning app, budgets are better spent on visible features. The upgrade is postponed again and again – and with every year that passes, it becomes more extensive and expensive.
Stop the guesswork with your Mendix 11 upgrade
With Mendix 11, developers finally get what legacy apps have lacked for years: a clear overview of their application and the tools to continue developing it with confidence.
1. Document your Mendix app before you change anything
The first step out of the unknown is a map. Maia, the AI assistant integrated into Studio Pro, and the Mendix CLI (mxcli) – a command-line tool from Mendix Labs that allows coding agents like Claude Code or Codex to work with a Mendix project – can both analyze an application and reveal its structure: modules, entities, microflows, pages, and the dependencies between them.
An agent can transform this metadata into clear documentation of how the app works, without a developer having to manually reconstruct it through reverse engineering. mxcli complements this with linting and best-practice reports that highlight issues and outdated patterns, making technical debt visible even before the migration begins.
2. Move fast without losing control
Once the app is documented, every change is easier to assess. The impact analysis from mxcli shows which microflows, pages, and entities are affected by a change before it is even implemented. More importantly, however, the documentation no longer becomes outdated.
After every change – whether it is a new page, a new attribute, or new business logic – the agent updates the documentation as part of the same task, serving two target groups simultaneously: developers and business users read it to understand the app, and AI agents use it to guide the next change or support an assistant that helps new users find their way.
Da Maia und mxcli auf dem Mendix-Modell arbeiten und nicht auf tausenden Zeilen von Rohcode, bleibt das Ergebnis leicht überprüfbar.
3. Treffen Sie fundierte Entscheidungen bei Ihrem Mendix-Upgrade
Wenn Sie sehen, was in der App enthalten ist, können Sie den Umfang des Upgrades bestimmen. Wenn Sie den Umfang kennen, können Sie den Aufwand schätzen, und die Budgetdiskussion wird zu einer geschäftlichen Entscheidung statt zu einem Sprung ins Ungewisse.
Auch die Plattform, auf die Sie upgraden, ist entscheidend. Mit Mendix 11.12, dem ersten Long-Term Support (LTS)-Release von Mendix 11, erhalten Teams eine stabile Grundlage für langfristige Wartbarkeit, Sicherheit und Skalierbarkeit. Die dazugehörigen KI-gestützten Tools sind bereit für geschäftskritische Produktionsanwendungen. Maia Plan verwandelt eine Beschreibung in Epics und User Stories, und Maia Make beginnt mit deren Implementierung, sodass sich die Investition noch lange nach der Migration auszahlt.
4. Legen Sie den Grundstein für das agentische Unternehmen
Eine Anwendung, die sich selbst dokumentiert, ist auch für die Zukunft gerüstet. Genau das erhalten Unternehmen mit Mendix im Kontext der Enterprise-Orchestrierung.
Als Teil des Siemens Intelligence Center X (ICX), der industriellen KI-Orchestrierungssoftware von Siemens, spielt Mendix zusammen mit Maia und mxcli eine wichtige Rolle dabei, Anwendungen sowohl für Agenten als auch für Menschen verständlich zu machen. Mit Mendix 11.12 kann eine App als MCP-Server fungieren, der seine Logik, Daten und Workflows für andere KI-Tools bereitstellt, und Mendix Workflows kann Agenten und Menschen innerhalb einer kontrollierten, prüfbaren Vertrauensebene orchestrieren und so die Grundlage für die hybride Belegschaft schaffen, die Menschen und KI-Agenten zusammenbringt.
Erleben Sie mxcli in Aktion: Ein Prompt, Feature und Dokumentation fertig
In einer kürzlich durchgeführten Demo zeigte Erick Souza, Senior Mendix Developer & Mendix MVP bei CLEVR, wie ein einziger Prompt ein neues Feature erstellen und gleichzeitig die Dokumentation aktualisieren kann. Niemand muss sich hinsetzen und dies nachträglich erledigen. Hier ist das, was er gezeigt hat, falls Sie keine Zeit haben, sich das vollständige Video anzusehen.
Könnte ein Entwickler diese Änderungen von Hand vornehmen? Natürlich, aber es würde länger dauern. Hier geschieht es jedes Mal automatisch.
Upgraden Sie sicher auf Mendix 11 – beginnen Sie mit Ihrer Dokumentation
Laden Sie mxcli von der Mendix Labs GitHub-Seite herunter, legen Sie es in Ihren Projektordner und führen Sie mxcli init aus. Innerhalb weniger Minuten ist Ihr Projekt bereit für den Coding-Agenten Ihrer Wahl, sei es Claude Code, Codex oder ein anderes Tool.
Von da an ist der erste Prompt der wertvollste: Bitten Sie den Agenten, den Inhalt Ihrer App zu dokumentieren. Machen Sie die Aktualisierung der Dokumentation dann zu einem festen Bestandteil jedes Prompts, damit das Wissen Ihres Teams mit der Anwendung wächst, anstatt hinterherzuhinken. Ein wichtiger Hinweis: mxcli ist noch Alpha-Software und entwickelt sich schnell weiter. Arbeiten Sie daher immer an einer Kopie Ihres Projekts oder unter Versionskontrolle und überprüfen Sie die Änderungen des Agenten so, wie Sie die Arbeit eines Kollegen überprüfen würden.
Das Ergebnis ist ein Fundament, auf dem Sie aufbauen können. Eine Anwendung, die Ihr Team versteht, ein Upgrade, das Sie planen können, und eine Architektur, die bereit für das agentische Unternehmen ist.
Sind Sie neugierig, wie das für Ihre Anwendungen aussehen könnte? Kontaktieren Sie CLEVR, um eine Demo anzufordern.
Finden Sie heraus, wie CLEVR die Wirkung Ihres Unternehmens steigern kann
FAQ
Can't find the answer to your question? Just get in touch
Was ist das Mendix CLI (mxcli)?
Das Mendix CLI, kurz mxcli, ist ein Befehlszeilen-Tool von Mendix Labs, das Mendix-Projekte für KI-Coding-Agenten wie Claude Code, Codex, Cursor und GitHub Copilot zugänglich macht. Da Mendix-Projekte in binären .mpr-Dateien gespeichert sind, die von Agenten nicht direkt gelesen werden können, übersetzt mxcli das Modell in MDL (Mendix Definition Language), eine SQL-ähnliche Syntax zum Abfragen und Ändern von Mendix-Modellen. Zudem bietet es Volltextsuche, Wirkungsanalysen, Linting und Best-Practice-Berichte, was es sowohl für das Verständnis bestehender Mendix-Anwendungen als auch für die Entwicklung neuer Projekte nützlich macht. Bitte beachten Sie, dass sich mxcli im Alpha-Stadium befindet; arbeiten Sie daher immer an einer Kopie Ihres Projekts oder nutzen Sie eine Versionsverwaltung.
Was ist der Unterschied zwischen Maia und der Mendix CLI?
Maia ist der KI-Assistent, der direkt in Mendix Studio Pro integriert ist. Er unterstützt Sie innerhalb der Modellierungsumgebung: Maia Plan wandelt eine Lösungsbeschreibung in Epics und User Stories um, und Maia Make beginnt mit der Umsetzung der definierten Aufgaben. Die Mendix CLI (mxcli) funktioniert genau umgekehrt: Sie öffnet Ihr Mendix-Projekt für externe KI-Coding-Agenten, die außerhalb von Studio Pro im Terminal oder in VS Code ausgeführt werden. In der Praxis ergänzen sich beide: Maia beschleunigt die tägliche Entwicklung in Studio Pro, während die mxcli für agentenbasierte Workflows geeignet ist, wie etwa das Dokumentieren einer bestehenden Anwendung, die Analyse von Auswirkungen bei Änderungen oder die Automatisierung repetitiver Modellierungsaufgaben.
Kann KI eine Dokumentation für eine bestehende Mendix-Anwendung erstellen?
Ja. Sowohl Maia als auch das Mendix CLI können eine Mendix-Anwendung analysieren und deren Struktur offenlegen: Module, Entitäten, Microflows, Seiten und die Abhängigkeiten zwischen ihnen. Ein KI-Agent kann diese Metadaten in eine lesbare Mendix-Dokumentation umwandeln, die die Funktionsweise der Anwendung erklärt, ohne dass ein Entwickler sie manuell per Reverse Engineering erschließen muss. Der größere Vorteil ist, dass die Dokumentation stets aktuell bleibt: Wenn der Agent ein Attribut hinzufügt, einen Validierungs-Microflow aktualisiert oder eine Seite ändert, passt er die Dokumentation im selben Durchgang an. Das Ergebnis ist eine Dokumentation, die sowohl von Entwicklern als auch von KI-Agenten genutzt werden kann – genau das macht eine Mendix-Legacy-Anwendung bereit für ein Upgrade auf Mendix 11.
