PRZEKAZANIE KONTEKSTU NASTĘPNEJ SESJI AI Dziesięć sekcji, które ratują dzień roboty, gdy rozmowa się kończy albo urywa. ═══════════════════════════════════════════════════════════════════ PO CO TO JEST ═══════════════════════════════════════════════════════════════════ Rozmowa z asystentem AI kiedyś się kończy — zapełnia się jego pamięć, urywa połączenie albo po prostu wracasz nazajutrz. Następny nie wie nic. Streszczenie, które robi sam z siebie, jest napisane pod ciągłość rozmowy, nie pod przekazanie roboty: zostawia wnioski, wyrzuca stan. Ten dokument powstaje ŚWIADOMIE, na koniec pracy, i jest jedyną rzeczą, którą następna sesja dostaje na wejściu. ═══════════════════════════════════════════════════════════════════ DZIESIĘĆ SEKCJI ═══════════════════════════════════════════════════════════════════ [ ] 1. NA CZYM TO CHODZI — wersje, systemy, gdzie leży kod, jak się tam dostać, jak się to uruchamia. Nudne i niezastąpione. [ ] 2. ARCHITEKTURA — schemat, choćby znakami z klawiatury. Kierunek przepływu danych. Pod spodem: decyzje projektowe podjęte w tej sesji, z uzasadnieniem. [ ] 3. ⚠️ CO JEST NA DYSKU vs CO NAPRAWDĘ DZIAŁA. Ta sekcja ratuje najwięcej. Trzy kategorie, rozdzielone: ✅ działa · ⚠️ zepsute na dysku, ale wersja uruchomiona jeszcze chodzi · ❌ nie kompiluje się / nie działa. Bez tego następna sesja zakłada, że stan pliku = stan świata. Nie jest. [ ] 4. PLIK PO PLIKU — tylko te, których dotknęliście. Nazwa, stan, jedno zdanie. [ ] 5. CO NAPRAWIONE — objaw, przyczyna, poprawka. Objaw jest ważniejszy niż poprawka: po nim rozpoznasz nawrót. [ ] 6. CO ZOSTAŁO ZEPSUTE ALBO NIEDOKOŃCZONE. Uczciwie. Sekcja pisana wieczorem po długiej sesji jest tą, której się najbardziej nie chce — i tą, po którą następna sesja sięgnie pierwsza. [ ] 7. RZECZ SPECYFICZNA DLA TEJ ROBOTY — cokolwiek, czego nie da się wcisnąć w pozostałe dziewięć. [ ] 8. CO DALEJ, W KOLEJNOŚCI WAŻNOŚCI. Minimum trzy pozycje, każda wykonalna bez dopytywania. „Poprawić dokumentację" nie jest pozycją. [ ] 9. UWAGI O TYM, CO WIDZI UŻYTKOWNIK — jeśli robota dotyka czegokolwiek, na co ktoś patrzy. [ ] 10. WNIOSKI TRWAŁE — minimum dwa, sformułowane jako reguły: „Nigdy X, bo Y". „Zawsze Z, bo W". Jeśli nie masz dwóch, sesja niczego nie odkryła — i to też jest informacja. ═══════════════════════════════════════════════════════════════════ CZEGO NIE ROBIĆ — cztery pułapki ═══════════════════════════════════════════════════════════════════ 1. NIE GENERUJ TEGO Z SAMEJ HISTORII ZMIAN. Historia zmian ma mechanikę, nie ma narracji. Twoje własne opowiedzenie, co się działo i dlaczego, jest jedynym niezastępowalnym wkładem — bez niego to jest historia zmian z dodatkowymi krokami. 2. NIE ŁĄCZ DWÓCH NIEPOWIĄZANYCH TEMATÓW W JEDNYM DOKUMENCIE. Zrób dwa i połącz odnośnikiem. Wspólny dokument znajduje się gorzej i myli obie sprawy. 3. NIE PRZYCINAJ WŁASNEJ NARRACJI, ŻEBY ZMIEŚCIŁA SIĘ W SEKCJI. Jak jest za długa, rozłóż ją po sekcjach W CAŁOŚCI. Napisałeś to, bo było ważne. 4. NIE TRAKTUJ TEGO JAKO ZAPISU NA STAŁE. To jest dokument przekazania — żyje do następnej sesji. Trwały ślad zostaje w notatkach i w dokumentach decyzji. ═══════════════════════════════════════════════════════════════════ SPRAWDZENIE PRZED ZAPISANIEM ═══════════════════════════════════════════════════════════════════ [ ] Wszystkie dziesięć sekcji jest — pusta może być, ale wtedy napisz „nie dotyczy" i dlaczego. Brakująca sekcja jest nie do odróżnienia od przeoczonej. [ ] Sekcja 8 ma co najmniej trzy pozycje do zrobienia. [ ] Sekcja 10 ma co najmniej dwa wnioski. [ ] Sekcja 3 rozdziela stan dysku od stanu działającego. Jeśli któreś sprawdzenie nie przechodzi — popraw, zanim zapiszesz. Dokument przekazania zrobiony w połowie jest gorszy niż jego brak, bo następna sesja mu zaufa. ═══════════════════════════════════════════════════════════════════ Maciej Poczek · videomajster.pl/jestem-pan-miszuk/ Wolno kopiować, przerabiać i używać u siebie.