Miałem kiedyś projekt, w którym trzy zespoły co tydzień przygotowywały nową wersję raportu. Plik nazywał się final_v27.pdf. Wersja 28 różniła się trzema przecinkami i jednym, niestety ważnym, założeniem w przypisie. W piątek wieczorem menedżer zapytał mnie: to działa czy nie działa. I wtedy dotarło do mnie, że problem nie leży w danych ani w modelu. Problemem jest to, że nasza wiedza siedzi w pliku, którego nie da się uruchomić.
Ten tekst jest o końcu kultu publikacji w formacie, który tylko wygląda na ostateczny. I o tym, dlaczego notatniki, potoki danych i proste dema są lepszym nośnikiem wiedzy niż elegancki pdf.
Wiedza jako produkt, nie ornament
Jeśli wiedza ma wpływać na decyzje, musi być uruchamialna. Nie chodzi o fajerwerki, tylko o możliwość przejścia ścieżki od problemu do wniosku bez skakania po mailach i screenach.
Co to znaczy w praktyce:
- repozytorium z krótkim readme, w którym piszę co zrobić, żeby odtworzyć wynik
- notatnik, który prowadzi użytkownika krok po kroku i pozwala zmienić parametr, zobaczyć efekt i wrócić
- potok, który codziennie uruchamia obliczenia i w razie potknięcia wysyła alert
- proste demo, na którym sponsor projektu zobaczy efekt na własnych danych
W tej układance pdf pełni co najwyżej rolę wizytówki. Zapowiada, że coś istnieje, ale nie daje rękojmi, że to zadziała jutro o 9.
Krótsza pętla problem − rozwiązanie − uruchomienie
Największa przewaga artefaktów nad plikami polega na skróceniu pętli. W klasycznym trybie wygląda to tak: zbieramy materiał, piszemy raport, czekamy na komentarze, poprawiamy, przekładamy spotkanie, bo ktoś jest na urlopie. Czasem mijają tygodnie, zanim ktokolwiek dotknie rzeczywistego procesu.
Artefakty to inna kolejność:
- Problem. Umawiamy kryterium sukcesu. Na przykład skrócenie czasu odpowiedzi na zapytanie klienta o 30 procent w ciągu miesiąca.
- Szkic. Powstaje notatnik z minimalnym zestawem danych i prostym pomiarem jakości. Tu jeszcze nie ma fajnej infografiki, za to widać gdzie boli.
- Spięcie. Dokładamy potok, który odpala ten notatnik na próbce co godzinę. Mamy pierwsze alerty, pierwsze błędy, pierwsze poprawki.
- Uruchomienie. Dajemy właścicielowi procesu małe demo. Pokazuje realny wpływ w środowisku zbliżonym do produkcji. Decyzja nie opiera się na deklaracji, tylko na działającym fragmencie.
Ta pętla bywa brzydsza wizualnie, ale prowadzi do wyniku szybciej. I pozwala wcześnie wykryć miejsca, w których plan rozjeżdża się z życiem.
Dlaczego pdf zwalnia organizację
Pdf zamraża kontekst. Znika informacja o wersjach bibliotek, o tym, jak wyglądał plik wejściowy, jakie wyjątki trzeba było złapać. Znika też odpowiedzialność, bo nikt nie wie, gdzie właściwie leży źródło prawdy. W efekcie:
- decyzje zapadają na bazie rycin, których nie da się powtórzyć
- spór o metodę przeradza się w spór o estetykę
- każda zmiana parametru wymaga nowej publikacji
Nie twierdzę, że pdf jest bezużyteczny. Ma sens przy audycie, w komunikacji z urzędem albo wtedy, gdy trzeba zostawić trwały ślad. Ale nawet wtedy można podać link do repo i krótką instrukcję odtworzenia wyniku.
Co wchodzi w pakiet artefaktów
Przez lata wypracowałem krótką listę rzeczy, które robią różnicę:
- plik środowiska i jasny sposób uruchomienia na czysto
- testy podstawowe na danych przykładowych z oczekiwanym wynikiem
- kontrakt danych, czyli prosta deklaracja kolumn i typów, które potok uznaje za poprawne
- logowanie i ślad zmian, tak żeby można było cofnąć się do wersji z zeszłego tygodnia
- małe demo webowe, choćby w stylu prostego panelu, na którym sponsor przesunie suwak i zobaczy konsekwencje
To nie są rakiety. To są nawyki, które zamieniają analizę w coś, co można podłączyć do realnego procesu.
Studium przypadku. jak sieć aptek przestała tonąć w wersjach raportu
Historia z polskiego podwórka. Sieć aptek z kilkuset placówkami co miesiąc produkowała raport o stanach magazynowych. Raport miał 60 stron i służył do podejmowania decyzji o zamówieniach. Problem polegał na tym, że decyzje trafiały na poziom regionalny za późno, a potem magazyn nadrabiał ekspresowymi dostawami. Koszt rósł, a ludzie byli zmęczeni wiecznymi poprawkami.
Poproszono mnie o pomoc. Zrobiłem trzy kroki.
Krok 1. Przeniosłem logikę z arkuszy do notatnika z prostym pomiarem trafności i krótkim komentarzem przy każdym założeniu. Menedżerowie mogli zmienić okno czasowe, próg rotacji i zobaczyć, co się stanie.
Krok 2. Zbudowaliśmy potok, który co noc liczył rekomendacje na świeżych danych i wysyłał dwa sygnały: listę pozycji do uzupełnienia oraz alerty o brakujących dostawach od producentów.
Krok 3. Dorzuciliśmy demo. Intencja była banalna. Kierownik regionu otwiera panel, wybiera trzy apteki, zmienia próg i widzi wpływ na wskaźnik braków oraz koszt transportu w kolejnym tygodniu.
Efekt po dwóch miesiącach był wyraźny. Zmniejszyła się liczba ekspresowych dostaw i liczba maili o tytule pilne, nowa wersja raportu. Co ważne, dyskusje przestały krążyć wokół zrzutów ekranu, a zaczęły dotyczyć tego, który wariant chcemy włączyć od poniedziałku. Pdf pozostał jako krótka notka dla zarządu, ale centrum ciężkości przeniosło się do artefaktów.
Nie wszystko było różowe. Pierwszy tydzień zjadły nam błędy w słownikach produktów i braki w danych. Tyle że zamiast spierać się o styl wykresu, naprawialiśmy coś, co naprawdę przeszkadzało.
Co mierzysz, tym stajesz się lepszy
Żeby utrzymać rozpęd, warto patrzeć na trzy proste metryki:
- czas od pomysłu do pierwszego uruchomienia na danych z życia
- czas powrotu po błędzie, czyli ile mija od czerwonego alarmu do zielonego
- wskaźnik użycia artefaktów przez osoby spoza zespołu technicznego, na przykład ilu kierowników loguje się do demo raz w tygodniu
Te trzy liczby mówią więcej o jakości pracy z wiedzą niż stos pdf-ów.
Co powie compliance i jak z tym żyć
Częsta obawa brzmi tak: u nas wszystko musi przejść akceptację, pdf jest bezpieczniejszy. Rozumiem ten argument, ale właśnie artefakty ułatwiają kontrolę. Testy, logi i ślad zmian tworzą materiał, który prawnik czy audytor zrozumie szybciej niż zestaw slajdów. A jeśli regulacje wymagają publikacji w określonej formie, nikt nie zabrania wygenerować krótkiego pdf-u prosto z repo i dołączyć linku do źródła.
Na koniec
Lubię ładne raporty. Serio. Ale jeszcze bardziej lubię, gdy ktoś po piętnastu minutach rozmowy mówi: dobra, włączamy to w trzech sklepach od środy. Artefakty są bliżej procesu. Pozwalają dotknąć konsekwencji. A to skraca pętlę problem − rozwiązanie − uruchomienie w sposób, którego nie da się osiągnąć nawet najbardziej eleganckim plikiem.
Zastanawiam się tylko, czemu tak długo broniliśmy rytuału final_v27.pdf. Może dlatego, że plik kusi poczuciem zakończenia. Tyle że praca z danymi rzadko ma koniec. Ma kolejne uruchomienie.