This use case (and yours as well) can be really useful and works well just by using ChatGPT. In many cases people are just building wrappers of gpt-4o, but I can see some room for improvement by building on top of OpenAI’s APIs.
I like to do the following:
"Review this code and give me a readme, include mermaid, swim diagrams to draw the logic."
Claude is great because it renders the mermaid in the artifact (most times).
then I can copy the mermaid into a mermaidlive (I still havent found the best mermaid site because some of them choke on the mmd output of claude and I dont know how to fix it sometimes...
for example - here is a mermaid where I was looking into how the universities, professors and families of SBF, Holmes and Ellison were tied:
https://i.imgur.com/njFKvmJ.png
Here is a mermaid of who sits on the agra committees, who funds their campaigns, and who did they make investments into wrt to the sugar lobby:
https://i.imgur.com/FGGcvxL.png
Having chatbots do mermaids is fn fantastic
It was one of the more impressive demonstrations of multimodal AI.
You can also import mermaid into Google's Draw.io app if you want to reflow or change the theme.