With Mendix 11 pushing AI further into the platform, I think it's time Maia helped us with something every developer secretly dreads — documentation. Right now, annotating complex microflows and nanoflows is almost always an afterthought. It either doesn't happen or it's a rushed one-liner that doesn't really explain the logic.
I'd like to see an option where Maia (or mxcli) can look at a flow and generate meaningful annotations for us almost like a "Maia Explain" that reads the flow and tells you in plain English what it's doing. Even better, a "Maia Make/Document" option that exports all of this into a proper document we can drop straight into a Technical Design Document, instead of writing it from scratch after the fact.
If a full annotation-writing feature is too big a first step, even a simpler version — mxcli spitting out a text summary of what a flow does — would already save a ton of time.
Why does this matter? Anyone who's had to pick up someone else's module (or their own flow from a year ago) knows the pain of reverse-engineering logic with zero context. This would make onboarding easier, TDD writing faster, and honestly just make our flows less of a mystery to the next person who opens them.