adr-documentation

Architecture Decision Records (ADR) documentation practice. Use when documenting architectural decisions, recording technical trade-offs, creating decision logs, or establishing architectural patterns. Trigger keywords - \

1. Aktywuj skill adr-documentation w swoim Claude'ie lub agencie — będzie gotowy do pracy, gdy w konwersacji pojawią się słowa kluczowe takie jak "ADR", "architektoniczne", "decyzja", "trade-offy" lub "log decyzji".

2. Kiedy potrzebujesz udokumentować decyzję architektoniczną, opisz problem, który rozwiązujesz — na przykład wybór między monolitem a architekturą mikroserwisów, decyzję o frameworku lub strategię skalowania bazy danych.

3. Skill pomoże Ci zebrać kontekst: jakie były ograniczenia, jakie opcje rozpatrywaliście i dlaczego odrzuciliście alternatywy. Dokumentuj zarówno to, co wybraliście, jak i to, co rozważaliście — ta wiedza jest cenna dla przyszłych zespołów.

4. Stwórz ADR jako lekki dokument — nie musi być długi. Zawrze powinien: stan problemu, rozpatrzone rozwiązania, wybrane rozwiązanie i jego konsekwencje. Skill będzie Ci podpowiadać strukturę.

5. Traktuj zaakceptowany ADR jako niezmienną historię decyzji. Jeśli sytuacja się zmieni i trzeba zmienić podejście, nie edytuj starego ADR — zamiast tego stwórz nowy dokument, który go superseduje i wyjaśnia, dlaczego zmiana była konieczna.

6. Zachowuj ADRy w repozytorium projektu (np. w folderze docs/adr/) — będą dostępne dla nowych członków zespołu, którzy chcą zrozumieć ewolucję systemu i przyczyny obecnych wyborów.