Kto utrzymuje instrukcje Claude Code i jak sprawdzić, czy nadal pomagają

Jak psują się pliki instrukcji

Bez właściciela CLAUDE.md zwykle dryfuje w ten sam sposób: uwagi z review i incydenty dodają linie, nikt żadnych nie usuwa, a plik zbiera komendy o zmienionych nazwach, sprzeczne reguły i obejścia ograniczeń, które miał starszy model. Dokumentacja Claude Code precyzyjnie opisuje koszt: pliki powyżej 200 linii zużywają więcej kontekstu i są gorzej przestrzegane, a gdy dwie instrukcje sobie przeczą, Claude może wybrać jedną z nich arbitralnie.

Rozwiązaniem jest odpowiedzialność i rutyna, która usuwa wpisy, a nie lepszy szablon. Poradnik Anthropic o context engineering zaleca najmniejszy zestaw instrukcji, który w pełni opisuje oczekiwane zachowanie: zaczynasz od minimum i dodajesz tylko dla błędów wykrytych w testach.

Kto jest właścicielem którego pliku

Claude Code wczytuje instrukcje z kilku poziomów i każdy potrzebuje innego właściciela. Poradnik Claude Code o dużych bazach kodu mówi, że plik danego katalogu zwykle utrzymuje jego właściciel, co może odpowiadać już istniejącemu podziałowi odpowiedzialności za kod.

• Zarządzany CLAUDE.md, rozsyłany na każdą maszynę: zespół platformowy albo bezpieczeństwa, dla wskazówek obowiązujących w całej organizacji. Reguły, które muszą obowiązywać, trafiają do zarządzanych ustawień, bo plik wskazuje kierunek, a niczego nie egzekwuje.
• CLAUDE.md albo AGENTS.md w katalogu głównym: zespół odpowiedzialny za build i konwencje repozytorium, zwykle platforma albo lider techniczny.
• Pliki CLAUDE.md w pakietach i .claude/rules ze ścieżkami: zespół, który jest właścicielem tego kodu, egzekwowane przez CODEOWNERS.
• CLAUDE.local.md i ~/.claude/CLAUDE.md: konkretny inżynier. Nikt ich nie przegląda, więc nie mogą zawierać reguł zespołu.
• Auto memory: pisana przez Claude, przechowywana per repozytorium na jednej maszynie i niewspółdzielona. Wszystko, na czym polega zespół, należy do przeglądanego pliku.

Zapisuj, po co istnieje każdy wpis

Wpis, którego nikt nie umie wyjaśnić, nigdy nie zostanie usunięty. Claude Code usuwa z CLAUDE.md komentarze HTML na poziomie bloków, zanim treść trafi do modelu, więc notatki dla opiekunów nie kosztują kontekstu. Zapisujemy w nich właściciela, powód i sposób sprawdzenia, czy wpis nadal działa.

<!-- owner: @example-org/billing | added 2026-08 after review findings on float maths | check: billing replay tasks -->
- Represent amounts with the Money type in src/billing/money.ts. Never use floating point for money.

<!-- owner: @example-org/billing | added 2026-05 | revisit after the next model change -->
- Integration tests need `docker compose up db` before `pnpm test:integration`.

Rutyna przeglądu, która usuwa tyle, ile dodaje

1. 1

   Przeglądaj każdą zmianę jak dokumentację

   Zmiany w plikach instrukcji przechodzą przez pull requesty z właścicielem pliku jako wymaganym recenzentem, także te, które proponuje sam Claude.

2. 2

   Uruchamiaj audyt w stałych odstępach

   /doctor prompt-audit w Claude Code, dostępny od v2.1.283, zgłasza odwołania do nieistniejących plików lub komend, instrukcje pisane pod starsze modele i sprzeczności, a niczego nie zmienia, dopóki nie zatwierdzisz poprawek.

3. 3

   Wracaj do plików po zmianach modelu

   Poradnik o dużych bazach kodu zauważa, że instrukcje omijające ograniczenie starszego modelu mogą stać się balastem, gdy nowszy model radzi sobie z danym przypadkiem sam.

4. 4

   Sprawdzaj, co faktycznie się wczytuje

   Uruchom /context, żeby zobaczyć, które pliki pamięci się wczytały, i użyj hooka InstructionsLoaded do logowania, kiedy wczytują się reguły ścieżek i zagnieżdżone pliki.

Jak sprawdzić, czy wpis nadal pomaga

Dla ważnych wpisów zrób małe porównanie. W hipotetycznym pakiecie rozliczeń weź pięć wcześniejszych zadań dotyczących kwot i uruchom każde trzy razy z wpisem o typie Money i trzy razy bez niego, każde uruchomienie w izolowanej kopii, której historia kończy się przed pierwotną zmianą, bez późniejszych refów, auto memory i plików z wcześniejszych przebiegów. Skrypt sprawdza każdy diff pod kątem arytmetyki zmiennoprzecinkowej na kwotach. Dodaj też zadania, w których reguła nie powinna niczego zmieniać, bo poradnik Anthropic o ewaluacji ostrzega, że jednostronne zestawy testów spychają zachowanie w jedną stronę.

Usuń albo przenieś wpis, gdy zachodzi jedna z tych sytuacji:

• Przebiegi z wpisem i bez niego zachowują się tak samo, więc model i tak to robi albo go ignoruje.
• Wskazuje pliki albo komendy, których już nie ma.
• To samo egzekwuje linter, hook albo check w CI, co jest mocniejsze niż zdanie w pliku.
• Dotyczy tylko jednego obszaru, więc należy do reguły ścieżek albo skilla wczytywanego na żądanie.

Gdzie jest miejsce na szkolenie

Odpowiedzialność nie zadziała, jeśli inżynierowie nie wiedzą, kiedy dodać wpis. Dokumentacja Claude Code daje praktyczny test: dodaj wpis, gdy Claude popełnia ten sam błąd drugi raz, gdy review wyłapuje coś, co Claude powinien był wiedzieć, albo gdy znów wpisujesz tę samą poprawkę. Dokładnie to ćwiczymy na szkoleniach zespołowych na waszych repozytoriach, gdy odpowiedzialność i rutyna przeglądu są już ustalone.

Szkolenia Claude CodeKontrola kontekstu, który niesie agent