[safetytrick]

Whenever I am in that expedient hack mode I've started commenting to explain my dilemma. My most valuable comments typically come out at that time.

Such and such can't be done right now because of such and such.

Often it doesn't matter if I ever resolve those comments or solve that problem I hacked through. The value comes from avoiding the rabbit hole next time.

[MichaelZuo]

Have you tried drawing a logical diagram/flow-chart of some kind?

[dharmab]

If it's simple enough, I'll embed a Mermaid diagram into a Markdown file committed with the change.