Architecture Decision Record to zwięzły zapis decyzji o istotnych konsekwencjach. Najprostsza struktura obejmuje tytuł, status, kontekst, decyzję i konsekwencje. W praktyce dodaj rozważone opcje oraz założenia, od których decyzja zależy.

Przykład fikcyjny: „Dla powiadomień o zmianie rezerwacji wybieramy kolejkę zamiast wywołania synchronicznego. Zyskujemy odporność na krótkie przerwy dostawcy, akceptując opóźnienie dostarczenia i konieczność obsługi ponowień”.

Przy aktualizacji decyzji dopisz nowy ADR i oznacz relację do poprzedniego. Dzięki temu można odtworzyć dlaczego rozwiązanie wygląda tak, a nie inaczej.

Źródło: ADR Templates — podstawowe elementy ADR ↗