code-associated specification files are just a part of the documentation context graph

^ code-associated specification file is a part of documentation context graph

For example, you can have a code-associated specification file, but for the graph to be complete, you should also have associated use cases that role up to design principles, persona needs, etc. Put that context right in the repo. If it's a documentation context graph, it needn't cause context rot because progressive disclosure is a fundamental aspect of graphs.