> But neither captures why it was written that way, the reasoning, the alternatives that were rejected, the trade-offs considered.

You're supposed to put that in the commitmsg.