Definicja
AGENTS.md
AGENTS.md to plik konfiguracyjny projektu, rozpoznawany przez Codex i coraz częściej przez inne narzędzia, definiujący zachowanie agentów AI w repozytorium. Umieszcza się go w katalogu głównym lub w podkatalogach; określa standardy kodowania, polecenia testowe, wzorce wdrożeń i preferencje narzędzi.
Dlaczego to ważne
To najbliższa neutralnej wobec dostawcy konwencja, jaką ta przestrzeń ma. Repozytorium z tym plikiem daje każdemu agentowi, który go rozpoznaje, te same standardy, polecenia testowe i wzorce wdrożeń, bez konfiguracji per narzędzie.
Jak radzi sobie z tym każde narzędzie
- Cursor
- Używa zamiast tego
.cursor/rulesi.cursorignore. - Claude Code
- Używa CLAUDE.md, w tym samym celu.
- Codex
- Format natywny, czytany hierarchicznie.
Najczęstsze pytania
Które narzędzia czytają AGENTS.md?
Codex rozpoznaje go natywnie, a inne narzędzia coraz częściej też. Claude Code czyta CLAUDE.md, a Cursor .cursor/rules, więc repozytorium obsługiwane przez kilku agentów zwykle zawiera więcej niż jeden z tych plików.
Co powinno znaleźć się w AGENTS.md?
Standardy kodowania, polecenia uruchamiające testy, wzorce wdrożeń i preferencje narzędzi — czyli to, co agent musiałby inaczej wywnioskować z kodu, czasem błędnie.
Czy repozytorium może mieć i AGENTS.md, i CLAUDE.md?
Tak i repozytoria obsługiwane przez więcej niż jednego agenta zwykle tak mają. Każde narzędzie czyta własną konwencję i ignoruje pozostałe, więc kosztem trzymania obu jest powielenie treści, a nie konflikt między nimi.