По-хорошему, высокоуровневые устойчивые концепции где-нибудь таки держать. А в остальном, лучший код - это документация:) ну или упороться в документор, который бы по коду генерил нужные диаграммы:)
не, мне так сложно не надо, хочется просто положить диаграммку как можно ближе к коду и чтобы мердж конфликт можно было зарезолвить в случае необходимости