Как ты документируешь архитектурные решения?

ADR (Architecture Decision Record): заголовок, контекст (почему нужно решение), варианты (минимум 2-3 с pros/cons), решение, последствия. Хранить в репозитории (docs/adr/). Нумеровать. Не менять после принятия — создавать новый ADR если решение пересмотрено. Lightweight: 1 страница достаточно. Цель: через год понять почему выбрали X а не Y.