Totally agree that heavy commenting is the best convention for helping the assistant help you best. I try to comment in a way that makes a file or function into a "story" or kind of a single narrative.
I was big on writing code to be easy to read for humans, but it being easy to read for AI hasn't been a large concern of mine.