in the WeWrite github repo, we have a /docs/ folder to host all living documentation to help us better vibe code according to the architectural decisions we've made in the past
To further strengthen our docs, I am considering the following
Adding README files to each folder
Top of file "why blocks" to explain why each file exists