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?