I'd go further: the problem isn't where the docs live, it's that nothing checks them against the code.

Yes, proximity indeed helps. However, I feel its better to automate docs revision using skills and related instructions in claude.mf/agents.md

I am building something in related problem, which is architecture visualisation