Sorry what is an ER diagram?

First hits on DDG, anonymous Google, Bing

ERD/ Entity Relationship Diagram https://www.lucidchart.com/pages/er-diagrams

ERM / Entity-Relationship Model https://en.wikipedia.org/wiki/Entity%E2%80%93relationship_mo...

(same-same, ERD is the more common acronym)

That is what I figured it would be, but you never know anymore with the amount of acronyms thrown around nowadays.

This has been my experience as well. imo documentation feels like one of the few areas that AI can be good at today.

It's okay but it often lies. At an SRE level you need a pretty zoomed-out view of the world until you are trying to zoom-in to a problem component.

Always start at the head (what a customer sees -- actually load the website) and work down into each layer.

If something is breaking way downstream and customers don't see it then it doesn't actually matter right now.

But how do you ensure the .md file is able to see all of the details of the infra?

You don't, it's a map of intent, not infra state. What exists, why, what talks to what. Live state still needs IaC and observability. The .md captures the 'why' that terraform can't

Im honestly looking for both. I haven't found a vender to do this well for just humans nor am I seeing something that can expose this context, read only, to all of the ai agent coding models

I will check that tool out.

So far the feedback has clustered around a few themes:

People want it to be significantly more proactive over time, things like root cause analysis, security-style probing, or guided investigations rather than just visibility.

There’s interest in going deeper on telemetry and using it to surface higher-level insights, not just raw data or links out to other tools.

A lot of people ask whether it can eventually write to environments. The direction that’s resonated most is doing this first for new or greenfield environments. For example, going from a prototype to a production-ready AWS setup in a more agentic way. For existing environments, trust and safety are still the gating factors.

My takeaway is that read-only context earns trust first, and write access has to be very deliberate and staged.