Why is diataxis outdated; don't your engineers ever read the code? Don't you think it helps the agents too?

Its just far easier to ask an agent to do the first past ( with references to actual code ) and then start to dig in.

A good implementation of something like this is https://deepwiki.com/ for OSS projects.