Asystent AI zapomina wszystko, gdy kończy się sesja. Plik z notatkami rozwiązuje ten problem. To zwykły plik tekstowy (w formacie Markdown) z faktami i zasadami, które asystent ma znać za każdym razem. Asystent czyta go na początku każdej sesji.

Każdy asystent używa własnej nazwy pliku:

Asystent	Nazwa pliku	Dla wszystkich projektów	Dla jednego projektu
Claude Code	`CLAUDE.md`	`~/.claude/CLAUDE.md`	`CLAUDE.md` lub `.claude/CLAUDE.md` w folderze projektu
Codex CLI	`AGENTS.md`	`~/.codex/AGENTS.md`	`AGENTS.md` w folderze projektu
Gemini CLI	`GEMINI.md`	`~/.gemini/GEMINI.md`	`GEMINI.md` w folderze projektu

~ oznacza folder domowy. Claude Code czyta też plik AGENTS.md z projektu, gdy nie ma w nim pliku CLAUDE.md. Dzięki temu jeden plik AGENTS.md może służyć dwóm asystentom.

Pozwól asystentowi napisać pierwszą wersję

Uruchom asystenta w folderze projektu i wpisz /init. Wszyscy trzej asystenci mają tę komendę. Asystent przegląda projekt i pisze wstępny plik z notatkami. Przeczytaj go i usuń wszystko, co jest błędne.

Zapisz to, co trzeba by tłumaczyć ponownie

Oto, co warto umieścić w pliku z notatkami:

Komendy do budowania, testowania i uruchamiania projektu.
Zasady stylu, na przykład „Używaj wcięć o szerokości 2 spacji”.
Informacje, gdzie co się znajduje, na przykład „Strony są w src/pages/”.
Zasady bezpieczeństwa, na przykład „Zapytaj mnie, zanim dodasz nową płatną usługę”.

Pisz zasady, które ktoś może sprawdzić. Przykład od Anthropic: zamiast „Testuj swoje zmiany” napisz „Uruchom npm test przed zapisaniem zmian w historii projektu (commit)”.

Mały przykład:

markdown

# Notatki dla asystenta

## Komendy
- Uruchom stronę: npm run dev
- Uruchom testy: npm test

## Zasady
- Używaj prostej polszczyzny we wszystkich tekstach na stronie.
- Zapytaj, zanim usuniesz jakikolwiek plik.

Dopisuj, gdy asystent powtarza błąd

Gdy asystent popełni ten sam błąd dwa razy, dodaj zasadę. Gdy w dwóch sesjach wpisujesz tę samą poprawkę, dopisz ją do pliku. OpenAI i Anthropic polecają ten nawyk. Możesz też poprosić asystenta, żeby sam dodał zasadę.

Niech będzie krótki

Cały plik z notatkami trafia do każdej sesji. Długi plik zajmuje więc dużo miejsca i może sprawić, że asystent gorzej go przestrzega. Anthropic zaleca mniej niż 200 wierszy w każdym pliku CLAUDE.md. Codex domyślnie przestaje czytać pliki z notatkami projektu po 32 KiB łącznie. Usuwaj stare zasady oraz zasady, które się nawzajem wykluczają.

Długie instrukcje krok po kroku przenieś z pliku z notatkami do umiejętności (skills). Asystent wczytuje taką umiejętność tylko wtedy, gdy jest potrzebna. Zobacz Umiejętności, agenci i konektory – wyjaśnienie.

Sprawdź, czy asystent wczytał plik

Asystent	Jak sprawdzić
Claude Code	Wpisz `/context` i zajrzyj do sekcji Memory files
Codex CLI	Poproś Codexa o listę źródeł instrukcji, które wczytał
Gemini CLI	Wpisz `/memory show`, aby zobaczyć wczytany tekst, lub `/memory list`, aby zobaczyć pliki

Nigdy nie wpisuj do pliku z notatkami haseł, kluczy API ani innych sekretów. Ludzie często udostępniają pliki z notatkami projektu innym osobom.

Źródła

code.claude.com/docs/en/memory
developers.openai.com/codex/guides/agents-md
developers.openai.com/codex/customization/overview
geminicli.com/docs/cli/gemini-md
geminicli.com/docs/reference/commands