Wyobraź sobie, że zatrudniasz nowego pracownika. Pierwszego dnia nie dajesz mu listy zadań i nie mówisz "działaj". Zamiast tego dostaje on manual firmy, zasady pracy, opis tonu komunikacji z klientami i wytyczne, czego absolutnie nie wolno robić. Po tygodniu działa jak wieloletni członek zespołu. Dokładnie taką logikę wprowadza plik AGENTS.md do świata agentów AI.
AGENTS.md to prosty plik tekstowy w formacie Markdown, który definiuje zachowanie agenta AI w konkretnym projekcie lub firmie. Zamiast za każdym razem tłumaczyć Claude'owi czy innemu modelowi, jak ma odpowiadać, jakich plików używać i jakich zasad przestrzegać, zapisujesz to raz. Agent czyta ten plik na starcie każdej rozmowy i dostosowuje się do Twojego zespołu.
Dla polskich małych i średnich firm to zmiana porządku rzeczy. Do tej pory praca z AI przypominała tłumaczenie tego samego stażyście każdego ranka. AGENTS.md kończy tę pętlę - raz skonfigurowany agent działa jak wyszkolony specjalista.
Czym właściwie jest AGENTS.md
Technicznie to zwykły plik Markdown umieszczony w głównym folderze projektu. Jego zawartość to instrukcje dla agenta AI: kim jest, co robi, jakich narzędzi używa, jakich zasad przestrzega i do kogo kieruje konkretne sprawy. Standard rozwinął się z ekosystemu Claude Code, GitHub Copilot i Cursor, ale koncepcja jest uniwersalna. Każdy nowoczesny asystent AI, który wspiera ten format, potrafi go odczytać i zastosować.
Kluczowa różnica między AGENTS.md a zwykłym promptowaniem polega na trwałości. Prompt piszesz za każdym razem od nowa. Plik konfiguracyjny działa stale, dla każdego członka zespołu, dla każdej sesji pracy. Nowa osoba wchodzi do projektu, klonuje repozytorium, uruchamia asystenta AI i automatycznie dostaje te same reguły, których używa doświadczony kolega.
Dobry AGENTS.md zawiera zwykle pięć elementów: kontekst firmy i projektu, role poszczególnych agentów, mapę decyzji (gdzie co zapisać), zasady komunikacji oraz przykłady "robić tak, nie robić inaczej". Całość zajmuje najczęściej od 100 do 500 linijek.
Praktyczne zastosowania w polskich firmach
Weźmy firmę doradczą z piętnastoma konsultantami. Każdy pracuje z klientami, pisze raporty, prowadzi projekty. Bez AGENTS.md każda osoba używa AI po swojemu - jeden stosuje formalny ton, drugi skraca raporty, trzeci miesza polski z angielskim. Klient otrzymuje dokumenty o różnej jakości i stylu.
Z AGENTS.md firma definiuje raz: "Raporty piszemy w formacie IBM - Issue, Background, Movement. Nagłówki w drugiej osobie. Liczby w tysiącach z separatorem spacji. Nigdy nie używamy słów 'innowacyjny' ani 'przełomowy'. Wnioski zawsze na początku, dane w załącznikach." Agent stosuje te zasady automatycznie, niezależnie od tego, kto z zespołu z niego korzysta.
Drugi przykład - kancelaria prawna. Prawnicy używają AI do wstępnej analizy umów, ale muszą mieć pewność, że system nie wyciąga niepewnych wniosków. AGENTS.md może zawierać reguły typu: "Nigdy nie podawaj orzecznictwa z pamięci - zawsze cytuj źródło i datę. Przy niepewności napisz 'wymaga weryfikacji prawnej'. Jeśli klauzula budzi wątpliwości, zaznacz ją kolorem i dodaj komentarz."
Trzeci - agencja marketingowa obsługująca dziesięć marek klientów. Każda marka ma inny ton, inną personę, inne zakazane słowa. AGENTS.md w folderze każdego klienta zawiera brand book w formie wykonywalnej. Agent piszący posta dla klienta A używa lekkiego, młodzieżowego tonu. Ten sam agent w folderze klienta B produkuje korporacyjną treść dla branży finansowej.
Jak zbudować pierwszy AGENTS.md
Zacznij od strony, na której spędzasz najwięcej czasu. Jeśli codziennie odpowiadasz na maile klientów, stwórz plik dla tej czynności. Jeśli najczęściej piszesz oferty handlowe, zacznij od tego obszaru. Zasada brzmi: automatyzuj to, co powtarzalne, zanim automatyzujesz to, co efektowne.
Struktura pliku powinna zawierać kilka sekcji. Pierwsza - kontekst firmy: branża, wielkość, klienci, produkty. Druga - role agentów: czy chcesz jednego uniwersalnego asystenta, czy kilku specjalistów (np. @marketing, @sprzedaz, @obsluga). Trzecia - zasady stylu: jak pisać, jakich słów unikać, jakiego tonu używać. Czwarta - mapa decyzji: gdzie zapisywać pliki, jak nazywać dokumenty, do kogo eskalować. Piąta - przykłady dobre i złe.
Kluczowa reguła - pisz konkretnie, nie abstrakcyjnie. Zamiast "pisz przystępnym tonem" użyj "używaj krótkich zdań, maksymalnie 15 słów, unikaj strony biernej, zaczynaj akapity od czasownika". Agent AI potrzebuje mierzalnych instrukcji, nie deklaracji wartości.
Drugi praktyczny patent - sekcja "czego NIGDY nie robić". Pisz ją w trybie rozkazującym: "nigdy nie obiecuj terminów bez konsultacji z project managerem", "nigdy nie podawaj cen z pamięci, zawsze sprawdzaj w cenniku", "nigdy nie kończ maila wykrzyknikiem". Zakazy działają u agentów AI lepiej niż nakazy, bo wycinają konkretne błędy.
Ograniczenia i pułapki
AGENTS.md nie jest magiczną różdżką. Po pierwsze - działa tylko z asystentami, które obsługują ten format. Claude Code, Cursor, GitHub Copilot, Aider - tak. Standardowa wersja webowa ChatGPT - nie natywnie, choć można skopiować treść jako prompt systemowy.
Po drugie - plik nie eliminuje halucynacji. Agent może świetnie znać zasady firmy, ale nadal wymyślać fakty, jeśli poprosisz go o informacje spoza kontekstu. Reguła "cytuj źródła" pomaga, ale nie zwalnia z weryfikacji.
Po trzecie - zarządzanie długim AGENTS.md to praca. Po sześciu miesiącach plik zaczyna zawierać sprzeczne reguły, przestarzałe procesy, zapomniane decyzje. Traktuj go jak kod - rób przeglądy, usuwaj martwe fragmenty, testuj zmiany. Osoba odpowiedzialna za utrzymanie to zwykle dyrektor operacyjny lub lider zespołu, który najlepiej zna procedury.
Po czwarte - AGENTS.md nie zastępuje szkolenia ludzi. Jeśli Twój zespół nie rozumie, dlaczego robimy coś tak a nie inaczej, agent AI tego nie naprawi. Plik koduje wiedzę, którą już posiadasz. Jeśli wiedza jest chaotyczna, agent też będzie chaotyczny.
Podsumowanie
AGENTS.md to prosty koncept o dużej sile - zamiast tłumaczyć AI za każdym razem, tłumaczysz raz. Dla polskich firm, które walczą o produktywność i jakość, to realne narzędzie skalowania wiedzy. Jeden konsultant może dzięki dobrze skonfigurowanemu agentowi obsłużyć pracę dwóch. Agencja reklamowa może utrzymać spójność marki klienta na poziomie, którego wcześniej nie osiągała nawet z dwoma copywriterami.
Zacznij mały. Stwórz plik dla jednego obszaru. Używaj go przez dwa tygodnie. Koryguj na podstawie realnych sytuacji. Potem dodaj kolejny obszar. W ciągu trzech miesięcy możesz mieć dokument, który zastępuje połowę onboardingu nowych pracowników i standaryzuje pracę całego zespołu.
Najważniejsza lekcja: agenci AI działają tak dobrze, jak dobrze ich skonfigurujesz. AGENTS.md to narzędzie do tej konfiguracji. Traktowane poważnie, zwraca się w pierwszym miesiącu.
Źródło: What makes a good AGENTS.md