Pfft… it’s been fine for the last 10 years.

Repo level markdown files with architectural guidance not working for example

I’ve seen it become less and less effective as the size of the file(s) grew and as the codebase grew - they got increasingly more diluted or even lost in context compression. After several months of a 6 man team working on the project the rate at which they got ignored started affecting output a lot.