We use Claude in an end-to-end managed process, generating project overviews, solution designs and implementation plans before launching into a team of agents to build (as well as multiple levels of review agents checking the work). Each stage is gated, and that involves reading docs - the better we read and understand them, the less rework is needed post initial build, and the faster we deliver. A bugbear though is the diagramming - we use md files for the docs we generate, and invariably we end up with text based representations of the design. Does anyone else do something similar? What do you use for Claude generated diagrams? Any top tips out there? Edit - update: Thanks for the responses - it feels a lot like people lean heavily towards Mermaid, with some shout-outs for MCP Servers into pro diagramming tools. That said, I think I really like the idea of a skill to generate HTML diagrams of a small number of types and will try that out for a while, see how it goes. submitted by /u/Strange-Grass6025
Originally posted by u/Strange-Grass6025 on r/ClaudeCode
