In some projects I work on I've added a WHY.md at the root that explains what's scaffolding and what's load bearing, essentially. I can't say it's been effective at preventing the problem you outlined, but at least it's cathartic.