Most of the problems in my life can be attributed to incorrect architecture documentation

Big fancy architecture diagrams are not documentation, they are scrap

They are most often written by someone without a clue