trending

12d ago

Be honest — when did your architecture diagram last match the code?

Every team I've been on has had "the diagram" somewhere a Miro board, a Lucid file, a photo of a whiteboard and on every team it was quietly wrong within a month or two. Nobody updates it, so eventually nobody trusts it, and new engineers just re-derive the system in their heads.

  • How do you document your system's architecture today and does it stay accurate?

  • Have you just given up on diagrams and rely on reading the code?

  • If a diagram could stay in sync automatically, what would it need to do for you to actually keep it around?

Not looking for validation I want the honest version, including "diagrams are a waste of time." Curious what's worked and what hasn't for you.

11d ago

Structly - Architecture as code — diagrams that update when code does

Describe your system in a sentence — or point Structly at a repo — and get a diagram you can actually read. Click a box to see what it does, press play to trace a request end to end. The JSON lives in your repo, so the picture changes when the code does.