This is very interesting, I've been following the discussion around Architecture.md [0], one of the issues mentioned was updating the doc. Going for a standardised way of organising the project might be helpful.
I've recently been working on simulations again and C++ has sparked my interest (also again, after not having touched it since CS106B), but I've had a hard time understanding some of the projects I've seen due to a lack of documentation. Irrespective of language, I do like this approach to have some predetermined and thought through way of structuring projects, both for other users and for the future self, without the overhead of adding much documentation.
[0]: https://news.ycombinator.com/item?id=26048784
