Upgraden naar Mendix 11: Hoe Maia en mxcli je documentatie up-to-date houden

Vraag een willekeurige Mendix-ontwikkelaar wat hij liever doet: een nieuwe functie bouwen of een halve dag besteden aan het documenteren van de vorige, en je kent het antwoord al. Documentatie is misschien veel minder dankbaar dan programmeren, maar dat is niet de enige reden waarom het onderaan de backlog belandt.

Onder strakke deadlines en de druk om werkende code op te leveren, is documentatie meestal het eerste dat sneuvelt. Wat er wel wordt geschreven, is vaak informeel, lastig te volgen en snel verouderd. Hoe rommeliger de bestaande documentatie wordt, hoe minder nut ontwikkelaars erin zien om deze bij te werken, en de kloof wordt met elke release alleen maar groter.

Wat als documentatie zichzelf up-to-date zou kunnen houden, mee zou schalen met de applicatie en herleidbaar zou zijn naar elke wijziging? Voor veel teams zou dit meer veranderen dan alleen de dagelijkse ontwikkeling. Het zou veranderen hoe ze aankijken tegen een upgrade naar Mendix 11.

De verborgen kosten van ongedocumenteerde Mendix-apps

Veel Mendix-applicaties draaien al jaren in productie, sommige sinds Mendix 6 of 7, en veel daarvan zijn bedrijfskritisch. Ze upgraden naar Mendix 11 zou een logische stap moeten zijn. In plaats daarvan voelt het vaak als een sprong in het diepe.

Wanneer zoveel van wat de app doet zich alleen in de hoofden van mensen bevindt, kan niemand precies zeggen wat erin zit, wat er kapot zal gaan of hoe lang het duurt om daarachter te komen. Hierdoor staan teams voor drie dilemma's:

1. Nu upgraden, of blijven bouwen op oude grond?

Upgraden betekent de confrontatie aangaan met wat jaren aan wijzigingen hebben achtergelaten: verborgen workarounds, verouderde widgets en oude modules die niemand zich meer herinnert. Elke grote Mendix-versie stelt bovendien oudere widgets, modules en Java-versies buiten gebruik, dus een upgrade betekent vaak dat onderdelen van de app vervangen moeten worden, in plaats van ze alleen opnieuw te compileren. Maar blijven zitten waar je zit, betekent dat elke nieuwe functie wordt gebouwd op een fundament dat steeds verder achterop raakt, terwijl Mendix 11-mogelijkheden zoals Maia buiten bereik blijven.

2. Snel bewegen, of stabiliteit behouden?

De business wil nieuwe functies, meer gebruikers en nieuwe integraties. Zonder documentatie kan echter niemand de impact van een wijziging voorspellen, en zonder tests of een duidelijke beschrijving van hoe elk proces zich hoort te gedragen, kan niemand bevestigen dat alles daarna nog steeds werkt. Elke release wordt een afweging tussen snelheid en stabiliteit, en het opschalen van de app wordt elke keer moeilijker.

3. Investeren in de upgrade, of in nieuwe functies?

Als je de omvang van een upgrade niet kunt bepalen, kun je deze niet inschatten. Elk proces moet handmatig worden gecontroleerd, en de ervaren ontwikkelaars die de vragen konden beantwoorden, zijn misschien al vertrokken. Geconfronteerd met onduidelijke kosten en een werkende app, gaan budgetten naar zichtbare functies. De upgrade wordt steeds uitgesteld, en elk jaar dat het wacht, wordt het groter en duurder.

Haal het giswerk uit je Mendix 11-upgrade

Met Mendix 11 krijgen ontwikkelaars eindelijk wat legacy-apps al jaren missen: een helder overzicht van hun applicatie en de tools om deze met vertrouwen aan te passen.

1. Documenteer je Mendix-app voordat je iets wijzigt

De eerste stap uit het onbekende is een kaart. Maia, de AI-assistent die in Studio Pro is ingebouwd, en de Mendix CLI (mxcli) – een command-line tool van Mendix Labs waarmee coding agents zoals Claude Code of Codex met een Mendix-project kunnen werken – kunnen beide een applicatie inspecteren en de structuur blootleggen: modules, entiteiten, microflows, pagina's en de onderlinge afhankelijkheden.

Een agent kan die metadata omzetten in duidelijke documentatie over hoe de app werkt, zonder dat een ontwikkelaar dit handmatig hoeft te reverse-engineeren. mxcli voegt linting en best-practice rapporten toe die problemen en verouderde patronen markeren, waardoor technische schuld zichtbaar wordt nog voordat de migratie begint.

2. Snel bewegen zonder de controle te verliezen

Zodra de app gedocumenteerd is, is elke wijziging makkelijker te beoordelen. De impactanalyse van mxcli laat zien welke microflows, pagina's en entiteiten een wijziging zal raken voordat iemand deze doorvoert. Maar belangrijker nog: de documentatie raakt niet langer achterop.

Na elke wijziging, of het nu gaat om een nieuwe pagina, een nieuw attribuut of nieuwe bedrijfslogica, werkt de agent de documentatie bij als onderdeel van dezelfde taak, waarmee twee doelgroepen tegelijk worden bediend. Ontwikkelaars en zakelijke gebruikers lezen het om de app te begrijpen, en AI-agents gebruiken het om de volgende wijziging te sturen of om een assistent aan te sturen die nieuwe gebruikers helpt hun weg te vinden.

Omdat Maia en mxcli werken op basis van het Mendix-model in plaats van duizenden regels ruwe code, blijft de output eenvoudig te controleren.

3. Maak van je Mendix-upgrade een weloverwogen beslissing

Wanneer je inzicht hebt in wat er in de app zit, kun je de scope van de upgrade bepalen. Als je de scope kunt bepalen, kun je een inschatting maken, en verandert de discussie over het budget van een sprong in het diepe in een zakelijke beslissing.

Het platform waarnaar je upgradet is ook van belang. Met Mendix 11.12, de eerste Long-Term Support (LTS)-release van Mendix 11, krijgen teams een stabiele basis voor onderhoudbaarheid, beveiliging en schaalbaarheid op de lange termijn. De bijbehorende AI-ondersteunde tools zijn bovendien klaar voor bedrijfskritische productie-apps. Maia Plan zet een beschrijving om in epics en user stories, en Maia Make begint met de implementatie ervan, zodat de investering nog lang na de migratie rendement oplevert.

4. Leg de basis voor de agentic enterprise

Een applicatie die zichzelf documenteert, is ook klaar voor wat er komen gaat. Dit is precies wat bedrijven krijgen met Mendix in de context van enterprise-orkestratie.

Als onderdeel van Siemens Intelligence Center X (ICX), de industriële AI-orkestratiesoftware van Siemens, speelt Mendix – samen met Maia en mxcli – een belangrijke rol in het begrijpelijk maken van applicaties voor zowel agents als mensen. Met Mendix 11.12 kan een app fungeren als een MCP-server die zijn logica, data en workflows blootstelt aan andere AI-tools, en Mendix Workflows kan agents en mensen aansturen binnen een beheerde, controleerbare vertrouwenslaag, waarmee de basis wordt gelegd voor het hybride personeelsbestand dat mensen en AI-agents samenbrengt.

Zie mxcli in actie: één prompt, feature en documentatie klaar

In een recente demo liet Erick Souza, Sr. Mendix Developer & Mendix MVP bij CLEVR, zien hoe één enkele prompt een nieuwe feature kan bouwen en tegelijkertijd de documentatie kan bijwerken. Niemand hoeft dit achteraf nog handmatig te doen. Hier is wat hij liet zien, voor als je geen tijd hebt om de volledige video te bekijken.

Zou een developer deze wijzigingen handmatig kunnen doorvoeren? Natuurlijk, maar het zou langer duren. Hier gebeurt het automatisch, elke keer weer.

Upgrade met vertrouwen naar Mendix 11, beginnend bij je documentatie

Download mxcli van de Mendix Labs GitHub-pagina, plaats het in je projectmap en voer mxcli init uit. Binnen enkele minuten is je project klaar voor de coding agent van jouw keuze, of dat nu Claude Code, Codex of een andere tool is.

Vanaf dat moment is de eerste prompt de meest waardevolle: vraag de agent om te documenteren wat er al in je app staat, maak het bijwerken van de documentatie vervolgens onderdeel van elke prompt, en de kennis van je team groeit mee met de applicatie in plaats van erachteraan te lopen. Eén waarschuwing: mxcli is nog alfa-software en ontwikkelt zich snel, dus werk altijd aan een kopie van je project of onder versiebeheer, en controleer de wijzigingen van de agent zoals je het werk van een collega zou controleren.

Het resultaat is een fundament waar je op kunt bouwen. Een applicatie die je team begrijpt, een upgrade die je kunt plannen en een architectuur die klaar is voor de agentic enterprise.

Benieuwd hoe dit er voor jouw applicaties uit zou kunnen zien? Neem contact op met CLEVR om een demo aan te vragen.