Fix the design of our Puppet codebase & document design guidelines

Original created by @intrigeri on 16958 (Redmine)

To upload designs, you'll need to enable LFS and have an admin enable hashed storage. More information