Every bug is someone else's workflow: https://xkcd.com/1172/

Also, extensive commenting inside codebases is useful documentation, incl. these kinds of incidents. Good code documents the how, but not why. Comments shall also include the "why" where applicable.