ADR (architecture decision record)

Krótki dokument trzymany przy kodzie, który zapisuje jedną decyzję architektoniczną: kontekst, opcje, wybór i jego konsekwencje.

Format zaproponował Michael Nygard w 2011. Każdy zapis to strona w repozytorium, numerowana i nieedytowana po przyjęciu; późniejsza decyzja, która ją odwraca, dostaje własny zapis. Nowi ludzie dowiadują się, dlaczego system jest taki, jaki jest, a zespół przestaje otwierać zamknięte już pytania. Dla kogoś, kto przejmuje oprogramowanie, folder z ADR-ami to jeden z najczytelniejszych znaków, że kod da się utrzymać.

Udostępnij: LinkedIn · X ·

Powiązane hasła

Dług techniczny: Skróty w kodzie i projekcie, które przyspieszają dostarczenie teraz, a spowalniają każdą późniejszą zmianę, dopóki ich nie spłacisz.
Runbook (instrukcja systemu): Krótki dokument, który mówi komuś innemu, jak prowadzić system: gdzie działa, jak wdrażać, jak go podnieść.
Model C4: Sposób rysowania architektury oprogramowania na czterech poziomach przybliżenia: kontekst systemu, kontenery, komponenty i kod.

← Wszystkie hasła

Darmowe narzędzia

Walidator pomysłu na biznesDziesięć rubryk, werdykt ze stałej reguły i trzy tanie eksperymenty. Za darmo.Ile kosztuje aplikacjaTwój projekt na tle 125 prawdziwych produktów, z uczciwym rozrzutem.Konfigurator współpracyWybierz pracę i jej wielkość, zobacz godziny, cenę i termin.Sprawdź SPF, DKIM i DMARCOcena DNS poczty dowolnej domeny, z rekordami do wklejenia.Sprawdź BIMIRekord, DMARC, logo SVG Tiny PS i VMC albo CMC, z podglądem w skrzynkach.Apka do App Store i Google PlayCzego apce webowej brakuje do sklepów, TWA czy Capacitor, pliki do skopiowania.Budować czy kupićSaaS kontra własna apka w 1, 3 albo 5 lat, z miesiącem zwrotu.Instrukcja systemuRUNBOOK.md dla systemu, który znasz tylko Ty, w dwie minuty, w przeglądarce.Kalkulator SLAOpłata, czasy reakcji, budżet przestojów i zapisy do umowy.Lokalny model czy API?Czy model zmieści się w sprzęcie, jak szybko, ile kosztuje wobec API.Konektor MCP z OpenAPIWklej OpenAPI, dostań wąskie narzędzia MCP i szkielet serwera.Walidator faktury KSeFSprawdź fakturę FA(3) oficjalnym schematem w przeglądarce.Kalkulator ofertowaniaGodziny na zamianę zapytań w oferty i kiedy zwróci się agent.Kalkulator multi-tenantKtóry model multi-tenant, praca przy wydaniu i tygodnie budowy.Oferta z zapytaniaWrzuć zapytanie klienta, dostań pozycje z Twojego cennika. Za darmo.Widoczność w AICzy Claude poleca Twoją markę? Tygodniowe przebiegi pytań klientów, za darmo.List DeskWyczyść listę e-mail w przeglądarce: martwe domeny, jednorazowe, literówki, duplikaty.Eval DeskPrzypadki testowe dla promptu AI, uruchamiane po każdej zmianie: co się zepsuło, co naprawiło.Dashboard DeskDashboard wzrostu utworzony w Twoim PostHogu, plus braki w śledzeniu.Signature DeskJeden szablon stopki dla całej firmy, jako HTML do Gmaila, Outlooka i Apple Mail.Czy ten mail to oszustwo?Przekaż podejrzanego maila albo wgraj plik .eml; trzy modele AI i sprawdzenia techniczne dają werdykt.Email TestWyślij jednego maila i sprawdź wypis jednym kliknięciem, SPF, DKIM, DMARC i sygnały spamu.Vitals DeskCodzienny pomiar laboratoryjny stron na spowolnionym telefonie: LCP, CLS i TBT oraz mail, gdy strona zwolni. Za darmo.Ile kosztuje przepisanie systemuLinie kodu na punkty funkcyjne, godziny i koszt, z agentami i bez.

Wolisz wersję na wesoło? Korpo Tłumacz ma słownik korpomowy: zwroty z biura i to, co naprawdę znaczą. Słownik korpomowy →

Trzeba to zbudować, naprawić albo przejrzeć?

Buduję i ratuję produkty z agentami kodującymi pod regułami: funkcje AI na produkcji, uczciwe wyceny, poczta, która dochodzi.

Umów darmowe 30 minut Zobacz cenę i termin

Jak pracuję

Przemysław Zalewski · 15+ lat doświadczenia w tworzeniu oprogramowania

„a true bias for action” CTO klienta, publiczna rekomendacja na LinkedInie

Poufność domyślnie. NDA to standard. Nie pokazuję Twojego projektu, nazwy ani zrzutów bez pisemnej zgody, dlatego na tej stronie nie ma nazw klientów, którzy się na to nie zgodzili.
Twój kod, Twoje konta. Kod i dane zostają w Twoim repo i na Twoich kontach. Narzędzia AI działają z wyłączonym trenowaniem na Twoich danych, a sekrety nigdy nie trafiają do modelu.
Przekazanie, z którego da się skorzystać. Każdy projekt kończy ta sama lista: README, które go uruchamia, jeden diagram architektury, spisane decyzje, CI, instrukcja utrzymania i nagrane omówienie. Gotowe, gdy ktoś spoza projektu uruchomi go z dokumentacji.
Nudna technologia tam, gdzie to ważne. Wybieram stos, do którego łatwo znaleźć ludzi. Wszystko eksperymentalne wymaga Twojej zgody i planu wyjścia.
Podejście dobrane do apetytu na ryzyko. Prototyp, produkt albo branża regulowana: poziom decyduje, ile swobody mają agenci i ile przeglądu i walidacji wymaga każda zmiana.
Wszystko do sprawdzenia. Każda liczba na moich stronach prowadzi do źródła. Narzędzia są darmowe, a skill walidatora pomysłów jest otwarty (MIT).

Moja obietnica

Odpowiedź w 24 godziny. Odpowiadam w ciągu 24 godzin w dni robocze. Osobiście, nie bot. Wiadomości z weekendu: do poniedziałku, do 12:00.
Spóźnienie znaczy gratis. Jeśli się spóźnię, pierwsza godzina pracy jest za darmo. Nie musisz o to prosić.
Zakres na piśmie w 24 godziny. Bezpłatna rozmowa 30 minut bez prezentacji firmy, potem zakres i cena na piśmie w ciągu 24 godzin. Ty decydujesz.
Osoba, która wykona pracę. Rozmawiasz z osobą, która wykona pracę. Bez warstwy sprzedaży, bez przekazywania dalej.
Odzywam się tylko z czymś nowym. Odzywam się tylko wtedy, gdy mam dla Ciebie coś nowego. Nigdy „czy jest już decyzja?”.
Uczciwe „to nie dla mnie”. Jeśli nie jestem właściwą osobą, mówię to na rozmowie i wskazuję kogoś, kto jest.

Wszystkie zasady, polityka AI i godziny pracy →

Cennik · Bezpieczeństwo · Prywatność i wyłączenie analityki · Centrum zaufania