[amadeuswoo]

One thing that’s evidently helped: using CLAUDE.md / agent instructions as de facto architecture docs. If the agent needs to understand system boundaries to work effectively, those docs actually get maintained

[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