Napisane dla
przyszłego
mnie.

Wprowadzenie

Każde zadanie w Monty Network, od wgrania jednego pliku po przeniesienie całej galerii zdjęć, żyje jako zgłoszenie w Monty Control. Zgłoszenie to jedyne miejsce, z którego pracuję. Mówi, dlaczego zadanie istnieje, jak je wykonać krok po kroku, jak udowodnić, że zadziałało, jak je cofnąć i kiedy jest skończone.

Większość systemów zgłoszeń powstaje dla zespołów, które dzielą między sobą pamięć o projekcie. Ja jestem jedną osobą, a moja pamięć o zadaniu blednie w chwili, gdy zamykam laptopa. Dlatego każde zgłoszenie piszę dla czytelnika, który wszystko zapomniał: dla siebie za tydzień albo za pół roku.

To studium przypadku bierze jedno prawdziwe zgłoszenie, MC-2026-0143, i przechodzi przez nie część po części: do czego służy każdy fragment i jakie zasady wokół niego wyrosły.

Rodzina zgłoszeń

Zgłoszenie nigdy nie stoi zupełnie samo. Duża praca dostaje jedno zgłoszenie główne, a każda jej część staje się pod nim zgłoszeniem podrzędnym, z krótkim kodem mówiącym, do której części sieci należy.

• Kody, które mówią gdzie. GALLERY to galeria zdjęć, VFML dziennik, MSOUNDS muzyka, MSOCIAL media społecznościowe, MSTATS statystyki. Numer zgłoszenia podrzędnego zawiera numer rodzica: MC-2026-0063-VFML-001.
• Nowe problemy dołączają do rodziny. Świeży problem w projekcie, który już trwa, staje się kolejnym zgłoszeniem podrzędnym, a nie nowym zgłoszeniem głównym.
• Drogowskazy, nie kopie. Zadanie Google i wątek w Logach nigdy nie zawierają instrukcji. Tylko wskazują na zgłoszenie, więc zawsze jest tylko jedna wersja, której można ufać.

Anatomia zgłoszenia

Oto MC-2026-0143, pierwsza próba przenoszenia moich galerii zdjęć ze SmugMug, tak jak wygląda na ekranie laptopa. Każda ponumerowana część ma jedno zadanie.

1. Tytuł. Zaczyna się od kodu, a potem mówi dokładnie, co zostanie zrobione. Łatwo go wyłowić z długiej listy.
2. Wstęp. Dlaczego zadanie istnieje, do którego projektu należy, co zmieni, a czego zmienić nie może.
3. Przewodnik dla opornych. Każdy krok, po kolei, w częściach, z dokładnymi słowami do wpisania.
4. Dowód. Polecenie do uruchomienia i odpowiedź, której należy się spodziewać.
5. Gdy coś pójdzie nie tak. Prawdopodobne usterki, ich naprawy i sposób, by wszystko cofnąć.
6. Kiedy zamknąć. Jedno zdanie, które decyduje, kiedy zadanie jest skończone.
7. Zamknij lub czekaj. Zamknięcie od razu odhacza zadanie Google i Logi; oczekiwanie odkłada zadanie, nie gubiąc go.
8. Co się wydarzyło. Każda zmiana zgłoszenia, zachowana jako jego historia.

Wstęp

Wstęp jest pisany dla kogoś, kto przychodzi bez żadnej wiedzy. W kilku zdaniach odpowiada na pięć pytań:

• Co to jest? Próbny przebieg obróbki zdjęć na trzech galeriach.
• Dlaczego istnieje? SmugMug kończy się 5 grudnia, a 97 galerii potrzebuje nowego domu.
• Gdzie należy? Pod MC-2026-0063, główne zgłoszenie galerii.
• Co się stanie? 103 zdjęcia zamienione na WebP i wysłane do nowego zasobnika.
• Czego nie wolno zmienić? Niczego na SmugMug ani na działającej stronie.

To ostatnie zdanie znaczy więcej, niż się wydaje. Powiedzenie, czego zadanie nie może dotknąć, wyznacza wokół niego linię bezpieczeństwa, a to linia, o której najczęściej się zapomina.

Przewodnik dla opornych

Nazwa jest celowa. Zmusza do pisania każdego kroku dla kogoś zmęczonego, rozkojarzonego i w pośpiechu, bo właśnie ktoś taki będzie go wykonywał.

• Części, nie ściana tekstu. Od części A do części E, każda z prostą nazwą. Część już ukończona mówi o tym, razem z datą.
• Gdzie to się dzieje. Kroki wymagające laptopa mówią przy laptopie, żeby zgłoszenie czytane na telefonie nie udawało, że da się je tam wykonać.
• Dokładne słowa. Nie skonfiguruj rclone, tylko jedna linijka do wpisania, z częściami do podmiany zapisanymi wielkimi literami.
• Powód kroku. Klucz, żeby laptop mógł wysyłać pliki mówi, do czego służy klucz, a nie tylko jak go utworzyć.
• Bezpieczeństwo w samym kroku. Sekret jest pokazywany tylko raz. Nie wklejaj go do czatu. Potem usuń notatkę.

Większość instrukcji przygotowuję razem z Claude, na podstawie rozmowy, w której zadanie zostało rozpracowane. Potem wykonuję je naprawdę, a wszystko, co nie zgadzało się z ekranem przede mną, wraca do zgłoszenia.

Dowód, że zadziałało

Krok nie jest skończony dlatego, że wydaje się skończony. Każdy ważny etap ma sprawdzenie: co uruchomić i jak wygląda dobra odpowiedź.

Liczby są najlepszym dowodem, bo nie da się ich źle odczytać. Liczba, która powinna wynosić 103, albo nią jest, albo nie.

Gdy coś pójdzie nie tak

Każde zgłoszenie zakłada, że coś się nie uda, i mówi, co wtedy zrobić, zanim to nastąpi. Poprawki są spisywane, gdy zadanie jest świeże w pamięci, a nie odkrywane o północy.

• Narzędzie nie jest rozpoznawane po instalacji. Zamknij okno i otwórz nowe.
• Wysyłanie zatrzymuje się w połowie. Uruchom ten sam krok jeszcze raz. Wyśle tylko to, czego brakuje.
• Pojawiają się linijki z błędami. Skopiuj je do czatu. Pozostałe zdjęcia i tak się przekonwertują.

Ostatnia linijka to zawsze droga powrotna. Cofnięcie: usuń foldery w zasobniku i folder z przekonwertowanymi zdjęciami. Niczego innego nie ruszano. Znając wyjście, dużo łatwiej zacząć.

Kiedy zamknąć

Każde zgłoszenie kończy się jednym zdaniem, które decyduje, kiedy jest skończone. Dla próby: zamknij to zgłoszenie, gdy potwierdzi się, że 103 próbne zdjęcia są w R2 i wyglądają dobrze. Nie wtedy, gdy wysyłanie się wykonało. Wtedy, gdy wynik został sprawdzony.

Zamknięcie robi wtedy trzy rzeczy naraz: zgłoszenie trafia do archiwum, jego zadanie Google zostaje odhaczone, a wątek w Logach się zamyka. Nic nie zostaje do połowy otwarte w innym miejscu.

• Czekanie to nie zamknięcie. Zadanie, które utknęło na czymś niezależnym ode mnie, oznaczam jako oczekujące, z informacją, na co czeka, i zostaje w kolejce.
• „Aktualne” to nie „zrobione”. Najnowszy kod na laptopie to jeszcze nie skończone zadanie, więc samo w sobie nigdy nie zamyka zgłoszenia.
• Rodziny zamyka się od dołu. Zgłoszenia głównego nie da się zamknąć, dopóki którekolwiek zgłoszenie podrzędne jest otwarte.

Zasady domu

Z czasem niektóre lekcje stały się zasadami, których przestrzega każde zgłoszenie. Każda wzięła się z prawdziwego błędu albo z sytuacji, w której niewiele brakowało.

• Jedno repozytorium, jeden folder na serwerze. Każde repozytorium w GitHubie odpowiada dokładnie jednemu folderowi na serwerze, o tej samej nazwie, więc zawsze wiem, gdzie szukać.
• Zmień nazwę, zanim podmienisz. Przed wgraniem nowej wersji pliku starej zmieniam nazwę zamiast ją nadpisywać, więc powrót zajmuje kilka sekund.
• Aplikacje podają swoją wersję. Każda zmiana aplikacji na Androida podnosi jej wersję, a zgłoszenie podaje nowy numer, więc wiem, że zainstalowana jest właściwa wersja.
• Pliki z kluczami się edytuje, nigdy nie podmienia. Plik z kluczami sieci zmieniam wyłącznie na miejscu.
• Sekrety nie trafiają do czatów. Klucze i hasła idą prosto tam, gdzie są potrzebne, nigdy do rozmowy.
• Każda zmiana zostawia ślad. Zmiany w Monty Control zawsze zapisują się w jego Logach.

Rezultaty

Metoda dowodzi swojej wartości przy dużej liczbie zadań. W dziewięć dni pod koniec października Monty Control mieścił więcej zgłoszeń, niż kiedyś śledziłem w miesiąc.

Większy rezultat jest cichszy. Nie siadam już do laptopa, zastanawiając się, co miałem zrobić. Otwieram zgłoszenie, a ono mi mówi.

Dane z 4 listopada 2026, z Monty Control.

Co dalej

Metoda będzie się dalej zmieniać, bo każde zgłoszenie, które trudno wykonać, czegoś ją uczy.

• Każde zgłoszenie zostaje osobną historią. Zadania w sieci rzadko są do siebie podobne, więc instrukcja żyje w zgłoszeniu, a nie w osobnej bibliotece procedur.
• Archiwum jest pamięcią. Zamknięte zgłoszenia zachowują swoje instrukcje i historię, więc raz wykonane zadanie można znów znaleźć, wyszukując je.

Czego się nauczyłem

Pisz dla osoby, która naprawdę to przeczyta. Nie dla tej, która zna projekt na wylot, tylko dla tej, która zupełnie o nim zapomniała. W moim przypadku to ta sama osoba, kilka tygodni później.