ADR - Architecture Decision Record https://adr.github.io https://engineering.atspotify.com/2020/04/when-should-i-write-an-architecture-decision-record
зачем и что это: это документы и процесс для документации принятия решений, которые стоит записывать и документировать.
очень часто в проектах бывает необходимость "сделать, так, а не вот так", или "принять решение to adapt определенный инструмент / решение / процесс" (i.e. понять rationale behind decisions), при этом отказавшись по определенным причинам от других вариантов.
чтобы каждый в команде (особенно важно при ротации команды), знал и понимал почему были приняты те или иные решения - а в том числе и AI agents - такие документы помогают понять decision making process - и в том числе создают культуру non blaiming + failure first (мы знаем риски, знаем что пойдет в худшем случае, изучили варианты -> приняли решение)