Sójka, orzechówka i CLAUDE.md

§ 1Człowiek, który rysował gwiazdę

Wyobraź sobie salę badań w Montrealu. Mężczyzna siedzi nad kartką z gwiazdą i ma ją obrysować ołówkiem. Haczyk polega na tym, że rękę widzi tylko w lustrze. Pierwszego dnia ręka błądzi. Trzeciego idzie prawie bez błędów. A on za każdym razem jest pewien, że robi to pierwszy raz w życiu.

To Henry Molaison, w podręcznikach H.M. W 1953 roku chirurdzy usunęli mu przednie części obu hipokampów, żeby zatrzymać padaczkę. Padaczka ustąpiła. Razem z nią zniknęła zdolność tworzenia nowych trwałych wspomnień o faktach i zdarzeniach. Została jednak pamięć ręki. Uczyła się czegoś, o czym głowa nie miała pojęcia.

Znasz ten obraz z własnego terminala. Każda sesja Claude Code zaczyna się od świeżego okna kontekstu. Rano otwierasz terminal, a twój pomocnik widzi repozytorium pierwszy raz. Wczorajsza dwugodzinna rozmowa o tym, czemu testy integracyjne potrzebują lokalnego Redisa, przepadła.

Zapytajmy więc, czego o pamięci między sesjami mogą nas nauczyć mózg, sójka i orzechówka. Okaże się, że całkiem sporo. Pierwsza lekcja przychodzi od razu: „pamięć” to zbiorcza nazwa na kilkanaście różnych urządzeń, a nie jedno urządzenie.

§ 2Dwanaście liter

Rok 1960. George Sperling na ułamek sekundy pokazuje ci dwanaście liter. Ktoś pyta, co było na ekranie. Wymieniasz trzy, może cztery. A jednak gdy zaraz po błysku dźwięk wskaże jeden rząd, odczytujesz go prawie bez błędu. Wszystkie litery były w twojej głowie. Po prostu zgasły szybciej, niż dało się je wypowiedzieć.

Tak działa pamięć sensoryczna. Obraz trzyma się poniżej sekundy, dźwięk kilka sekund, bo dźwięku nie da się obejrzeć drugi raz. Najważniejszą robotę wykonuje tu sito, a nie magazyn.

W Claude Code tym sitem jest surowy wynik narzędzi: log z testów, ślad stosu, odpowiedź API. Wpada do kontekstu, coś się z niego bierze i powinien zniknąć. Kompaktowanie najpierw czyści stare wyniki narzędzi. To biologiczne maskowanie i warto je zaakceptować. Plik na dysku możesz przeczytać jeszcze raz, więc nie musisz go pamiętać. Ulotne są tylko rzeczy jednorazowe, na przykład ślad błędu z CI albo wynik migracji na stagingu.

§ 3Stół na cztery rzeczy

Teraz usiądź przy stole warsztatowym. Jest mały. Nelson Cowan policzył, że mieszczą się na nim mniej więcej cztery rzeczy naraz, a nie siedem, jak mówiło stare powiedzenie. Da się oszukać ten limit tylko w jeden sposób: pakując wiele drobiazgów w jedną paczkę, którą rozumiesz.

Alan Baddeley dorzucił do stołu kierownika, który niczego nie przechowuje, tylko kieruje uwagą. Szczury w labiryncie z wieloma ramionami pokazały jeszcze jedno rozróżnienie: „w tym ramieniu już byłem” to coś innego niż „te ramiona w ogóle się opłacają”.

Dla agenta tym stołem jest okno kontekstu. Jego pojemność liczy się w spójnych jednostkach uwagi, a nie w tokenach. Badacze systemu MemGPT kazali modelowi bić na alarm przy siedemdziesięciu procentach zapełnienia, żeby zdążył zapisać ważne rzeczy, zanim zostaną wypchnięte.

H.M. stracił jedną szufladę, a zachował drugą. To najważniejszy wniosek z jego historii: fakty i zdarzenia mieszkają w mózgu gdzie indziej niż umiejętności i odruchy. Agent też powinien trzymać je osobno i sięgać po nie innymi drogami.

§ 4Sójka i larwa

Zachodnia sójka zakopuje jedzenie. Larwę, która jest pyszna, ale szybko się psuje, i orzech, który poczeka. W 1998 roku Nicola Clayton i Anthony Dickinson pokazali, że sójka pamięta, co schowała, gdzie i kiedy. Gdy od schowania larwy minęło za dużo czasu, sójka po nią nie wraca. Idzie po orzech.

Badacze byli ostrożni. Nazwali to pamięcią epizodopodobną, bo nie da się wykazać, że ptak przeżywa wspomnienie tak jak człowiek. Zapamiętaj tę ostrożność, przyda się później.

Teraz popatrz na swoje notatki. „Build jest zielony” psuje się w godzinę jak larwa. „Migracje bazy leżą w katalogu migrations/” wytrzyma miesiące jak orzech. Claude Code dopisuje do plików pamięci czas zapisu, czyli sójcze „kiedy”. Brakuje mu jednak „do kiedy”.

§ 5Wiedza bez wspomnienia

Wiesz, że Warszawa leży nad Wisłą. Nie pamiętasz lekcji, z której to wiesz. To pamięć semantyczna: wiedza, która zapomniała, skąd przyszła. Rośnie z wielu podobnych epizodów.

Frederic Bartlett opowiadał Anglikom indiańską legendę i prosił, żeby ją powtórzyli. W powtórzeniach „kanoe” zamieniały się w „łodzie”. To, co nie pasowało do schematu, znikało albo się prostowało. Dlatego w notatkach o projekcie najcenniejsze są wyjątki: „ten moduł nie używa autowiringu, bo integruje stary kod przez fasadę”. To właśnie one giną najszybciej.

W Claude Code pamięcią semantyczną jest CLAUDE.md. Dokumentacja ma tu kryterium, które mógłby podpisać kognitywista: wpis warto dodać, gdy Claude popełnia ten sam błąd drugi raz albo gdy wpisujesz w czacie tę samą poprawkę co w poprzedniej sesji. Powtarzający się epizod zamienia się w wiedzę.

§ 6Ręka wie lepiej

Wróć do gwiazdy w lustrze. Ręka H.M. nauczyła się zadania bez żadnego wspomnienia o ćwiczeniu. To pamięć proceduralna. U agentów daje największe i najpewniejsze zyski. Voyager, agent grający w Minecrafta z biblioteką umiejętności zapisanych jako kod, zdobywał 3,3 razy więcej unikalnych przedmiotów. ExpeL prowadzi listę lekcji z wagami: nowa lekcja startuje z wagą dwa, a gdy waga spadnie do zera, lekcja znika.

Claude Code ma tu dwa mechanizmy i dokumentacja jasno je rozdziela. Wieloetapowe przepisy idą do skilli, ładowanych dopiero wtedy, gdy są potrzebne. To, co musi się wydarzyć zawsze, idzie do hooków, czyli poleceń uruchamianych w stałych punktach sesji niezależnie od tego, co zdecyduje model. Dokumentacja przypomina też uczciwie, że CLAUDE.md to kontekst, a nie konfiguracja. Model go czyta, ale nie ma obowiązku słuchać.

Hook jest ręką, która obrysowuje gwiazdę bez udziału świadomości. Nie musi niczego pamiętać.

§ 7Odruchy

Pod szufladami są jeszcze odruchy. Torowanie: świeży bodziec przesuwa to, jak myślisz o następnym. Warunkowanie: sygnał zapowiada skutek. Habituacja: przestajesz reagować na to, co się powtarza i nic nie znaczy.

Każdy z nich ma odpowiednik w hooku albo w krótkim pliku. Torowanie to hook UserPromptSubmit, który przy każdym poleceniu dokleja dwie, trzy pasujące notatki. Warunkowanie to rejestr niestabilnych testów („ten bywa czerwony przez timeout bazy, uruchom raz ponownie”). Habituacja to filtr powtarzalnych ostrzeżeń.

Habituacja ma jednak biologiczną pułapkę. Możesz przegapić sygnał, który właśnie zmienił znaczenie. Dlatego każde „ignoruj” powinno mieć datę ważności.

§ 8Biblioteka po drodze

Masz w torbie przetrzymaną książkę. Nie myślisz o niej cały dzień. Przypomina ci się dopiero, gdy mijasz bibliotekę. To pamięć prospektywna, pamięć o tym, co masz zrobić. Wersja oparta na zdarzeniu działa dobrze. Wersja oparta na godzinie działa gorzej, bo wewnętrzny zegar zawodzi.

Jej największym wrogiem jest przerwa. W jednym z badań tylko dwóch na stu przerwanych uczestników myślało w czasie przerwy o swoim zamiarze. Dla agenta przerwą jest koniec sesji albo kompaktowanie.

I tu jest niespodzianka. Opracowanie, na którym stoi ta opowieść, nie znalazło w literaturze ani jednego systemu agentowego, który oceniałby pamięć prospektywną jako osobny rodzaj pamięci. A Claude Code ma do niej gotowy mechanizm, choć nikt go tak nie nazywa. Reguła z polem paths ładuje się dokładnie wtedy, gdy Claude dotyka pasującego pliku. Ścieżka jest biblioteką po drodze.

§ 9Przesunięte patyki

Orzechówka chowa na zimę ponad trzydzieści tysięcy nasion i odnajduje je nawet po dziewięciu miesiącach. Badacze przesunęli punkty orientacyjne o mniej więcej dwadzieścia centymetrów. Ptak kopał z dokładnie takim samym przesunięciem. Nie pamięta miejsca na świecie. Pamięta miejsce względem patyków.

Auto memory w Claude Code jest zbudowane jak gospodarstwo orzechówki. Indeks MEMORY.md to mapa kryjówek, pliki tematyczne to same nasiona. Na starcie wczytuje się tylko pierwsze dwieście linii albo dwadzieścia pięć kilobajtów indeksu. Treść za tą granicą nie jest „słabiej pamiętana”. W ogóle się nie wczytuje.

Łosoś wraca do rodzinnej rzeki kaskadą: przez ocean prowadzi go magnetyczny odcisk ujścia, ostatni odcinek węch. Agent może szukać tak samo. Najpierw moduł, potem grep w module.

§ 10Sen, który przegląda dzień

Zasypiasz. Hipokamp odtwarza dzisiejsze ślady w tej samej kolejności, w jakiej się wydarzyły, i przeplata je ze starą wiedzą w korze. Szybki uczeń przekazuje notatki powolnemu. Gdyby wpisywał nowości wprost, rozbiłby to, co już jest. Badacze nazywają to katastrofalną interferencją.

Sen jest wybiórczy. W jednym z badań zysk ze snu mieli tylko ci, którym zapowiedziano test. W innym sen prawie trzykrotnie zwiększał szansę odkrycia ukrytej reguły. Ale sen dokłada też fałszywe wspomnienia „istoty”: pamiętasz sens, którego nikt nie powiedział.

Claude Code ma dziś pierwsze elementy snu. Przypomina o skracaniu indeksu, a polecenie /doctor prompt-audit szuka sprzeczności i rzeczy przestarzałych. Brakuje mu replayu: regularnego przejścia przez świeże epizody z jednym pytaniem, co z tego jest wiedzą, a co tylko się wydarzyło.

§ 11Wspomnienie otwarte do edycji

W 2000 roku Karim Nader pokazał, że przywołane wspomnienie na chwilę traci stabilność. Lek podany zaraz po przypomnieniu je wymazywał. Sześć godzin później już nie. Elizabeth Loftus pokazała drugą stronę: informacja podana po zdarzeniu zanieczyszcza wspomnienie, a w badaniach w rodzaju „zgubiłeś się w centrum handlowym” mniej więcej trzecia część osób wytworzyła częściowo albo całkiem fałszywe wspomnienie.

Notatka, którą model może poprawić przy każdym odczycie, dryfuje jak historia opowiadana po raz dwudziesty. Streszczenie streszczenia potrafi po cichu zgubić rzadką, ale krytyczną instrukcję.

§ 12Matrona i muszka

Muszka owocowa zapomina aktywnie. Ta sama dopamina, która tworzy ślad, potrafi go wymazać. Gdy ją zablokować, pamięć sprzed trzech godzin trwa mniej więcej dwa razy dłużej. Zapominanie działa jak filtr.

Teraz posłuchaj o słoniach. W 1993 roku przez park w Tanzanii przeszła susza. Lepiej przetrwały stada prowadzone przez stare matrony. Ich zachowanie przypisuje się pamięci suszy sprzed ponad trzydziestu lat. Z szesnastu zmarłych cieląt dziesięć należało do stada z najmłodszą przewodniczką, które zostało w parku.

Pamięć plikowa nie blaknie wcale. Jest za to twardo ucinana na granicy limitu. Brakuje jej środka między wiecznością a nicością.

§ 13Ktoś patrzył

Wróćmy do sójki. Kiedy chowa jedzenie, a obok siedzi inna sójka, później wraca i przenosi schowek. Robi to tylko wtedy, gdy ktoś patrzył, i tylko jeśli sama kiedyś kradła. Pamięta nawet, który osobnik ją obserwował. Ten ptak prowadzi księgę źródeł.

Agent też potrzebuje takiej księgi. Wpis, który przyszedł z treści zewnętrznej, czyli ze strony WWW, z opisu zgłoszenia albo z README zależności, jest schowkiem, na który ktoś patrzył. W badaniu MINJA złośliwe rekordy dało się wstrzyknąć do pamięci agenta samymi zapytaniami, w 98,2% prób.

§ 14Mrówka nie pamięta

Kolonia mrówek żniwiarek żyje dwadzieścia, trzydzieści lat. Robotnica najwyżej rok. Kolonia pamięta przez ślady, które mrówki zostawiają w środowisku. To stygmergia: koordynacja przez wspólne otoczenie zamiast przez rozmowę.

Twoi subagenci są jak robotnice. Żyją krótko, a repozytorium jest kolonią. Jest jednak haczyk. Gdy każdy subagent pracuje we własnym worktree, plik statusu w repozytorium istnieje w tylu kopiach, ilu jest agentów. Siedmiu agentów widzi siedem różnych prawd. A katalog auto memory jest dla wszystkich worktree jednego repozytorium wspólny, więc mogą do niego trafić sprzeczne wpisy.

Mrówki nie edytują cudzego feromonu. Każda zostawia własny. Pszczoła, która obejrzała dużo tańca, leci tam, gdzie wskazał taniec. Ta, która obejrzała mało, leci tam, gdzie była wcześniej. Przekaz od innych waży się z własną wiedzą.

Na koniec Otto. W eksperymencie myślowym Clarka i Chalmersa Otto choruje na Alzheimera i nosi notes. Notes jest częścią jego pamięci, jeśli jest zawsze pod ręką, a jego treść przyjmowana bez wahania. Pliki agenta nie są zapasem. Są jego właściwą pamięcią długotrwałą. To zdanie jest zarazem wymaganiem i ostrzeżeniem, bo „bez wahania” znaczy też „bez sprawdzania”.

§ 15Gdzie te analogie kłamią

Do tej pory opowieść była dla analogii bardzo życzliwa. Teraz uczciwość.

Trzeba też oddać sprawiedliwość. Rozdział na pamięć pisaną przez człowieka i pamięć pisaną przez model to dobra decyzja. Ładowanie kontekstu po dotknięciu pliku to sprytne torowanie. Indeks z plikami na żądanie to dobrze skopiowana orzechówka. A najbardziej dojrzałe jest to, że dokumentacja przyznaje: pamięć tekstowa nie gwarantuje posłuszeństwa, i wskazuje mechanizm, który je gwarantuje.

§ 16Jutro rano

Kolejność ma znaczenie. Pierwsze kroki usuwają prawdziwe awarie, dalsze budują warstwy, a sen ma sens dopiero wtedy, gdy jest z czego śnić.

1. Sprawdź, co naprawdę się wczytuje. Uruchom /context i przejrzyj listę plików pamięci. Pamięć, która się nie ładuje, nie istnieje.najtańsza diagnoza
2. Przenieś bramki z prozy do hooków. Zakaz pusha bez akceptacji to blokada w PreToolUse, a nie zdanie w CLAUDE.md.ręka zamiast głowy
3. Zmierz blat. Główny CLAUDE.md poniżej dwustu linii. Wiedza o jednym zakątku do reguł z paths, przepisy do skilli.pamięć robocza
4. Stan zadania do pliku, który przetrwa kompaktowanie. Hook startowy wstrzykuje go z powrotem razem z tabu-listą.stół i labirynt
5. Zapisz pierwszy zamiar przy ścieżce. „Gdy dotkniesz X, zrób Y” w regule z zakresem.biblioteka po drodze
6. Zaplanuj sen. Piętnaście minut tygodniowo w kalendarzu: awans powtarzających się poprawek, porządki w indeksie, audyt instrukcji. Kalendarz, bo zamiary oparte na czasie lepiej trzymać poza agentem.konsolidacja

Do tej pory opowieść szła po śladach przeglądów i badań. Na koniec dostał głos ktoś, kto tej opowieści nie słyszał. Osobny agent dostał tylko opracowanie, listę pomysłów, których ma nie powtarzać, i jedną prośbę: wymyśl sześć mechanizmów z różnych dziedzin, których tam nie ma, i nie zmyślaj faktów.

Najpierw odrzucił trzy pomysły, które przyszły mu do głowy jako pierwsze, bo były typowe: wektorową bazę epizodów, powtórki rozłożone w czasie i graf wiedzy. Odrzucił też czwarty, bo za mało różnił się od kotwic. Zostało sześć. Każdy ma etykietę: wszystkie da się zbudować dziś, żadnego jeszcze nie sprawdzono w praktyce.

Gdyby miał zacząć od jednego, wybrałby znaki kamieniarskie: korzystają z gita, który już jest, nie dokładają magazynu i usuwają ryzyko przesuniętych patyków.

Koda

H.M. przez pół wieku pomagał nauce, choć nie pamiętał żadnego z tysięcy badań, w których brał udział. Jego ręka pamiętała jednak gwiazdę. Twój agent jest w podobnej sytuacji, tylko ma jedną przewagę: ktoś może mu napisać notatkę.

Pisz ją z ostrożnością sójki, która wie, kiedy larwa się psuje i kto patrzył. Układaj ją jak orzechówka, względem patyków, najważniejsze na górze. A gdy nie wiesz, co z niej wyrzucić, pomyśl o starej słonicy, która pamięta suszę sprzed trzydziestu lat, i o muszce, która zapomina, żeby móc się uczyć.

Najlepsza pamięć też umie zapominać. Ale wie, czego nie wolno.