Yeah diagrams as code "seems" to be the silver bullet but we're not sure how useful it is at large company scale. Sequence diagrams are super helpful! We have a sexy flows feature in IcePanel for easily creating a similar thing.