if your readme is meant to only ever be read by 'agents' then fine. if you want actual humans to read it, write in a human language, not LLM-speak.
it literally could not be more simple.
It's written in english. And probably written better than the average human would do.
If you don't like it, explain why. Otherwise you all just sound like divas.
LLM docs suck and I’d rather have no docs if a human is too lazy to write them well, at least I can tell my LLM to look at the code.
Sure, but you're not going to waste your time (and money) having an LLM look through random piles of source code. That's kindof the point of these generated READMEs that you hate so much: to give you an idea of if you want to investigate it more deeply.
If it bothers you so much, just ignore the README. But this "how dare they present this garbage to me!" is an entitled and hypocritical rant that's being repeated over and over and it needs to stop.
It's explained all over this thread, but you've ignored this for some reason.