Refaktoryzacja czy przepisanie od zera? Jak zdecydować

Refaktoryzacja to zmiana kodu, która poprawia jego strukturę, nie zmieniając tego, co robi oprogramowanie. Refaktoryzacja czy przepisanie od zera to decyzja o tym, ile miesięcy roadmapy są Państwo gotowi zatrzymać. Refaktoryzacja małymi krokami zwykle wygrywa, bo produkt w tym czasie nadal zarabia.

Przepisanie od zera ma sens w trzech przypadkach: kod robi niewłaściwą rzecz, nie należy do Państwa albo działa na technologii bez wsparcia. Poniżej znajdą Państwo tabelę decyzyjną i sposób na refaktoryzację bez zatrzymywania roadmapy.

Większość naszego kodu pisze AI. Senior przegląda każdą zmianę i odpowiada za produkcję. Przez lata rozwijaliśmy SaaS, z którego codziennie korzystało 60 000+ osób. Nigdy nie został przepisany od zera. Zmieniał się dzięki małym, przejrzanym zmianom, bezpośrednio w działającym produkcie.

Dlaczego duże przepisanie prawie zawsze kosztuje więcej, niż się wydaje?

Przepisanie wygląda czysto, bo nowy kod nie ma jeszcze historii. Ale tej historii Państwo potrzebują. Za każdym dziwnym warunkiem w starym kodzie zwykle stoi czyjaś reklamacja.

Najczęstsze powody, dla których przepisanie robi się drogie:

Kiedy refaktoryzować, a kiedy przepisać: tabela decyzyjna

Proszę zwrócić uwagę na ostatni wiersz. „Nikt tego nie rozumie” to najczęstszy argument za przepisaniem. I zarazem najgorszy. Nowy zespół, który nie rozumie starego kodu, przepisze go bez poprawek, które ten kod zawiera.

Przepisanie to też najłatwiejszy upsell. Częściej wystarczy kontynuować moduł po module i zacząć od najbardziej ryzykownej części, na przykład logowania i uprawnień.

Jak refaktoryzować bez zatrzymywania roadmapy?

AI wykonuje tu powolną, nudną część. Testy istniejącego zachowania, przenoszenie kodu, zmiana nazw. Senior decyduje, co się zmienia i w jakiej kolejności. Reguły, które dajemy do tego AI, opisujemy w artykule Reguły dla kodu AI w zespole.

Bez testów i code review AI jedynie szybciej powiększa Państwa dług techniczny. Dlatego mówimy, że agent to model plus harness. Harness to to, co zatrzymuje złą zmianę.

Kiedy przepisanie od zera jest właściwą decyzją?

Gdy kod nie należy do Państwa. Jeśli pierwotny system nie jest Państwa, nie ma czego refaktoryzować: buduje się nowy, a dane się przenosi.

Przepisanie przebiega w tej samej kolejności. Najpierw dane i zrozumienie, co system naprawdę robi. Potem ekran po ekranie, nie wszystko jednego dnia.

Przed decyzją proszę przejść przez sześć punktów. Proszę zaznaczyć to, co jest prawdą w Państwa systemie:

Czwarty punkt waży najwięcej. Jeśli kod robi właściwą rzecz, tylko źle, refaktoryzacja.

Kiedy tego nie zalecamy

• Mają Państwo seniora, który zna system i ma na to czas. Proszę refaktoryzować samodzielnie. Tabela powyżej wystarczy.
• System zostanie wyłączony za kilka miesięcy. Nie warto inwestować w kod, który się kończy. Lepiej zainwestować w przeniesienie danych.

Chcą Państwo podjąć decyzję z kimś, kto robi to na co dzień?

Senior od pierwszego dnia pracuje w Państwa repozytorium i pull requestach. Najpierw testy, potem zmiany małymi krokami, a roadmapa idzie dalej. Tak pracujemy jako zewnętrzni programiści dla zespołów produktowych.

Proszę napisać, która część kodu Państwa spowalnia. Odezwiemy się w ciągu dwóch dni roboczych z kilkoma pytaniami o Państwa pracę. Potem ustalimy, co zrobimy najpierw.

Jeśli wolą Państwo najpierw porozmawiać, proszę zarezerwować 15-minutową rozmowę wstępną.

Którą część swojego kodu najchętniej wyrzuciliby Państwo i dlaczego?

Najczęstsze pytania

Kiedy refaktoryzować, a kiedy przepisać kod od zera?

Refaktoryzacja, gdy kod robi właściwą rzecz, ale trudno go zmienić. Przepisanie, gdy robi niewłaściwą rzecz, kod nie należy do Państwa albo technologia straciła wsparcie. Nawet wtedy przepisuje się po kawałku, nie wszystko naraz.

Czy można refaktoryzować bez testów?

Można, ale to hazard. Najpierw proszę napisać testy obecnego zachowania, łącznie z błędami. Dopiero potem zmieniać kod. Bez testów o błędzie dowiedzą się Państwo od klienta.

Ile trwa refaktoryzacja?

Nie ma stałego końca i to jest w porządku. Odbywa się na bieżąco w zwykłych pull requestach, tam, gdzie i tak Państwo pracują. Osobny projekt refaktoryzacji trwający miesiącami zwykle nigdy się nie kończy.

Czy AI pomaga w refaktoryzacji?

Tak, przy pisaniu testów, przenoszeniu kodu i zmianie nazw. Decyzja, co zmienić i w jakiej kolejności, zostaje przy seniorze. Bez testów i code review AI sprawia jedynie, że błędy pojawiają się szybciej.