Poznajcie system, zanim zaczniecie go zmieniać

Celem jest zrozumienie, co system robi i dlaczego, bez zatrzymywania jego bieżącej pracy. Najpierw sprawdźcie mapę dokumentacji, potem poznajcie dokładnie obszar potrzebny do najbliższego zadania. Nie zaczynajcie od podmiany plików na starter ani wyboru nowego hostingu.

Uzupełnijcie wiedzę o działającym systemie

Porównajcie obecne strony z układem dokumentacji operacyjnej. Wskażcie braki i nieaktualne opisy. Od razu uzupełniajcie obszary potrzebne do zmiany oraz krytyczne dla utrzymania; pozostałe wpiszcie do istniejącego planu z osobą odpowiedzialną. Rozpoznanie jednego scenariusza poniżej dostarczy treści do odpowiednich stron w Confluence. To część uzupełniania dokumentacji systemu.

Przejdźcie jeden scenariusz od początku do końca

Otwórzcie funkcję, którą macie zmienić. Przejdźcie ją tak, jak robi to użytkownik: wprowadźcie dane, wykonajcie czynność i sprawdźcie wynik. Powtórzcie próbę dla pustych danych oraz znanego wyjątku. Wybierzcie dane dopuszczone do testów. Porównajcie wynik z dokumentacją i poproście agenta o wskazanie odpowiedzialnych plików. Jeśli nie możecie uruchomić próby, zapiszcie, co ją blokuje; sam odczyt kodu nie potwierdza działania.

1. Wskażcie wersję systemu, cel rozpoznania i zakres dostępnych źródeł.
2. Odtwórzcie zachowanie: co użytkownik podaje, co otrzymuje i jakie są wyjątki. Poszukajcie dowodu w dokumentacji, kodzie, testach lub bezpiecznym podglądzie.
3. Zapytajcie o reguły dziedziny: po co powstały, kto je potwierdza i kiedy nie obowiązują.
4. Połączcie scenariusz z danymi, częściami kodu oraz innymi systemami, od których zależy.

To inżynieria odwrotna: odtwarzacie działanie ze źródeł. Reengineering, czyli przeprojektowanie rozwiązania, przyjdzie dopiero wtedy, gdy uzasadnia go cel.

Dajcie agentowi plik do uzupełnienia

Dołączcie plik do rozmowy w projekcie. Agent zaczyna od odczytu. Kod pokazuje, jak coś działa; sam nie dowodzi, dlaczego ktoś tak zaprojektował system.

Rozpoznajmy obszar [opis] potrzebny do zadania [link]. Dozwolone źródła: [repozytorium i dokumenty]. Przeczytaj załączony plik i uzupełnij go na podstawie dowodów. Pokaż scenariusz, reguły i wyjątki, dane, powiązania z kodem i zależności. Podaj źródło i wersję. Historycznego „dlaczego” nie zgaduj z kodu. Oddziel fakty, hipotezy, luki i sprzeczności. Zapytaj o brakujące informacje. Wskaż istniejące strony dokumentacji, które trzeba uzupełnić tym wynikiem. Niczego nie zmieniaj w systemie ani w jego dostępie; pokaż wynik do sprawdzenia.

Sprawdźcie, czy wiedza wystarcza do pracy

Poproście agenta o wyjaśnienie zwykłego przypadku, wyjątku i sytuacji z brakującymi danymi. Przy odpowiedzi ma wskazać źródło. Przy sprzeczności — pokazać oba źródła i pytanie do osoby znającej dziedzinę. Jawne „nie wiem” jest lepsze niż dopisana reguła.

Wynik: opis jednego scenariusza, jego zależności i niewiadomych, sprawdzony przez osobę znającą system. Po uzgodnieniu zmian wpiszcie potwierdzoną wiedzę do właściwych stron Confluence. Pozostałe luki mają właścicieli i dalszy ciąg w planie. Teraz wybierzcie: zmieniacie sposób pracy z agentami czy sam system?