The 'graveyard' of architecture diagrams that were accurate for two weeks is painfully familiar, and the reason given is right: the diagram cannot read the compose file or manifests that are the real source of truth. Rendering EXPLAIN (FORMAT JSON) plans as a heat-mapped tree is a clever extra, since query plans are hard to read as raw JSON. Round-tripping with Mermaid and D2 also means the diagram can live in the repo next to the code it describes.