[kennethops]

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

[amadeuswoo]

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