just get ai to generate mermaid, it's super competent at doing it, you don't really need any other tools.

I’ve found that it can do it, but the aesthetics of the diagrams it generates are awful. I end up going back to manual Omnigraffle.

There is an art to designing the human to human communication aspect of diagrams that transcends which lines connect where.

I created https://smalldocs.org to help with this. After installing you can tell your agent to "sdoc me a mermaid diagram of X flow" or "sdoc me a visual architecture of this repo" or something, and it handles it nicely (imo!).

Here is the mermaid diagram gallery: https://smalldocs.org/s/PpArByXuNBA5kGS1JVMUW6#k=uTqNRLqzz_T...

Code available: https://github.com/espressoplease/smalldocs

Discord: https://discord.gg/txjATTsDaq

Yeah the main product I'm working on (Moxie Docs) has AI generation of mermaid diagrams, I find that it works __well enough__ but I needed some strong guardrails, quality checks, and templating to make sure it doesn't generate broken diagrams (or useless ones). First few iterations it would create a diagram for everything and it was a bit zealous on when it decided diagrams would be useful.