My Project Docs Aren't For Humans Anymore. They're For an Agent That Re-Reads Them Every Session.

I used to write docs/ the way I was taught: prose paragraphs, a little context, a "why we did this" narrative you'd hand to a new hire. Then I noticed something. The only reader opening those files ev...