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