u/Glass-Outcome5985

Genuine question I've been chewing on. Every diagramming tool I've used (draw.io, Lucid, Miro, Excalidraw) treats shapes as pictures, not as instances of types. A "database" is just a labeled rectangle. With the growing complexities of applications, it seems most of the details are not being captured.

I think this is why diagrams drift, not laziness or bad process. The diagram has no relationship to the running system from the moment it's drawn — so of course it's wrong six months later. There's no shared schema to compare against, nothing to validate, nothing to flag when reality has moved.

The pushback I take seriously: maybe it's a discipline problem. Teams that care keep diagrams alive in even bad tools. Teams that don't care won't be saved by better tools.

I'm not fully convinced though. Tools shape behavior more than discipline shapes tools, in my experience.

Curious whether anyone here has worked at a company where architecture docs were genuinely healthy — does your choice of tools make the difference, or was it pure culture?

Hey everyone, long-time lurker here. I've been building a diagramming tool called Grafica for the past few months and I'd genuinely value this sub's feedback before I get too deep into the next phase. The short version: it's an interactive diagramming app that captures much richer detail than existing diagramming tools, more like an application blueprint where each node type captures different attributes (e.g database, api, compute ...etc) and same for the edges. It also comes with two AI features that I think are interesting — one generates a first-pass architecture diagram from a prompt, and another lets you chat with the agent and refine the diagram (agent has context of the diagram).

What I'm specifically looking for:

1. Is this too complex to work with or to jump in and start drawing up diagrams
2. Any obvious gaps vs. what you currently use (Excalidraw, draw.io, Miro, Lucid, etc.)
3. Do architecture diagrams/docs actually get used in your team, or do they become stale?
4. Do you find it hard to learn and become familiar with a new application diagram using existing tools ?

There is a short blog that goes over the flow of the application. Also, the app has a free tier but I'm also happy to completely waive the fees for builder tier to some users. Dm me for this pls.