These problems read like they are a product of outdated ai assisted practices. I can imagine stuff like this happening when copy pasting from/to ai online chat

These problems read like they are a product of outdated ai assisted practices. I can imagine stuff like this happening when copy pasting from/to ai online chat interfaces, but not in a properly initialized project. The agent will read all the crappy, partly outdated documentation all over the project and also take the reality of the project into consideration. It's probably a good idea to also let it rewrite the programmer facing docs. Who else is going to maintain that realistically?