Szablon rejestru decyzji dla Ważnych Decyzji Technicznych (ITD)

To jest szablon Ważnych Decyzji Technicznych (ang. Important Technical Decisions, ITD) opisany w ITDs: a lean ADR for executive technical decision-making at scale - Ignacio Larrañaga.

ITD to ukierunkowana ewolucja ADR, zoptymalizowana pod kątem szybkości, jasności i zatwierdzania przez kierownictwo. Podczas gdy ADR dokumentuje to, co postanowiono, ITD jest szczupłym artefaktem, w którym na pierwszym miejscu jest decyzja, dzięki czemu sama decyzja podlega przeglądowi, a interesariusze mogą ją szybko przejrzeć i łatwo zakwestionować. ITD dobrze nadają się do decyzji technicznych, które nie są ściśle architektoniczne, takich jak wybór modelu, biblioteki lub strategii CI/CD.

W każdym pliku ITD napisz te sekcje:

Tytuł

Podaj samą decyzję, a nie opis tematu. Na przykład: „Używamy Qwen2.5 1.5B Instruct do tłumaczenia na urządzeniu”.

Problem

Jedno zdanie opisujące, co próbujemy rozwiązać.

Rozważane opcje

Alternatywy, które były na stole, z wybraną opcją pogrubioną.

Uzasadnienie

Tylko decydujące czynniki, które doprowadziły do wyboru, a nie wyczerpująca lista wszystkich zalet i wad.

Uwagi

Opcjonalnie. Wszelki dodatkowy kontekst warty zapisania, taki jak ograniczenia, założenia lub odnośniki.