decisions
Skill do tworzenia i edycji dokumentów decyzji architektonicznych i produktowych
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Proceduralna wiedza dla zespołów pracujących z ADR (Architecture Decision Records) i PDR (Product Decision Records) w katalogu docs/decisions/. Skill zawiera szablony obowiązkowe, reguły nazewnictwa, zarządzanie statusami decyzji oraz wytyczne, kiedy tworzyć ADR (wybory implementacyjne, wzorce) a kiedy PDR (zmiany upstream, zakres funkcji). Każda decyzja jest niezależnie śledzona, referencjonowana i może być zastąpiona.
Jak używać
Przed utworzeniem lub edycją jakiegokolwiek dokumentu decyzji przeczytaj odpowiedni szablon: docs/decisions/architecture/TEMPLATE.md dla ADR lub docs/decisions/product/TEMPLATE.md dla PDR — szablony są obowiązkowe.
Ustal typ decyzji: użyj ADR dla wyborów implementacyjnych, wzorców i kompromisów długoterminowych; użyj PDR dla zmian upstream, zakresu funkcji i zewnętrznych sterowników.
Nazwij plik zgodnie z konwencją NNN-kebab-case-title.md, gdzie NNN to sekwencyjny numer w danej kategorii, a tytuł opisuje decyzję w formie łańcucha ze znakami minus.
Ustaw datę decyzji na dzień, kiedy decyzja została faktycznie podjęta, a nie kiedy została udokumentowana — dla istniejących decyzji zweryfikuj historię git za pomocą git log --format="%ai" commit -1.
Przypisz status decyzji: proposed (rozpatrywana), accepted (sfinalizowana), deprecated (nieaktualna) lub superseded by {ADR,PDR}-NNN (zastąpiona inną decyzją).
Dla PDR upewnij się, że pole upstream zawiera link do zewnętrznego sterownika — może to być zmiana schematu, API lub decyzja z upstream projektu.