CLAUDE.md to plik, ktory ksztaltuje sposob, w jaki Claude rozumie Twoj projekt. Dobrze napisany oznacza mniej poprawek, lepszy kod i agentow, ktorzy faktycznie wiedza, nad czym pracuja.
Ten poradnik przeprowadzi Cie przez kazda sekcje pliku CLAUDE.md: od deklaracji stosu technologicznego po wskazowki dla poszczegolnych agentow. Postepuj krok po kroku i stworz wlasny plik.
CLAUDE.md to plik Markdown umieszczony w katalogu glownym projektu. Gdy Claude Code rozpoczyna sesje, czyta ten plik jako pierwszy. Wszystko w nim staje sie czescia kontekstu Claude: Twoj stos technologiczny, struktura plikow, konwencje zespolu i wszelkie konkretne instrukcje, ktorych ma przestrzegac kazdy agent.
Traktuj to jako dokument briefingowy. Bez niego Claude musi zgadywac, jak zorganizowany jest Twoj projekt. Z dobrym plikiem CLAUDE.md Claude juz wie, gdzie co sie znajduje, jakich wzorcow uzywac i czego unikac. Roznica w jakosci wynikow jest znaczaca.
“10 minut pracy nad CLAUDE.md oszczedza godziny poprawiania kodu wygenerowanego przez AI, ktory nie pasuje do wzorcow Twojego projektu.”
Na podstawie obserwacji setek projektow Claude Code
Struktura i dokladnosc pliku CLAUDE.md bezposrednio wplywaja na jakosc pracy Claude w Twojej bazie kodu.
Dobrze skonstruowany plik CLAUDE.md obejmuje te szesc obszarow. Kazdy dostarcza Claude konkretnych informacji, z ktorymi moze natychmiast pracowac.
Wymien jawnie swoje frameworki, biblioteki i ich wersje. Podaj menedzera pakietow, wersje Node i wszelkie wymagania srodowiska uruchomieniowego. Claude uzywa tego do generowania kompatybilnego kodu bez zgadywania.
Opisz kluczowe katalogi i co sie w kazdym znajduje. Komponenty, store, serwisy, trasy API, typy. Krotki diagram drzewa z jednoliniowym opisem kazdego folderu sprawdza sie dobrze.
Udokumentuj konwencje nazewnictwa (camelCase dla plikow, PascalCase dla komponentow), podejscie do obslugi bledow, kolejnosc importow i wszelkie reguly specyficzne dla projektu. Dzieki temu wyniki Claude pozostaja spojne z istniejacym kodem.
Dolacz komendy dev, build, test i lint. Gdy Claude musi cos zweryfikowac lub zaproponowac skrypt, uzyje dokladnie tych komend, ktorych oczekuje Twoj projekt.
Jesli uzywasz wielu agentow (QA, Frontend, Backend, DevOps), dodaj sekcje opisujaca, na czym powinna skupic sie kazda rola. Jest to szczegolnie przydatne przy konfiguracji wieloagentowej AgentsRoom.
Powiedz Claude, czego NIE robic. Nie modyfikowac plikow konfiguracyjnych, nie zmieniac systemu autoryzacji, nie refaktoryzowac warstwy bazy danych. Jawne granice zapobiegaja niepozadanym zmianom ze strony agentow.
Nie musisz pisac wszystkiego naraz. Zacznij od podstaw i rozszerzaj w miare odkrywania, co Claude musi wiedziec.
Otworz package.json i wymien kazdy framework, biblioteke i narzedzie uzywane w projekcie. Zapisz wersje. Sprawdz wymagania srodowiska (wersja Node, wersja Python, baza danych). Z tego powstanie sekcja stosu technologicznego.
package.json + wersje srodowiska + baza danych
Zrob szybki przeglad drzewa katalogu src. Zidentyfikuj foldery najwyzszego poziomu i napisz jednoliniowy opis kazdego z nich. Skup sie na lokalizacji komponentow, store, serwisow, typow i tras API.
Drzewo src/ z opisami przeznaczenia
Przejrzyj istniejacy kod i zanotuj wzorce: jak nazywasz pliki, jak obslugujesz bledy, jak strukturyzujesz importy, czy uzywasz default czy named exports. Zapisz je jako krotkie reguly.
Nazewnictwo, importy, obsluga bledow, eksporty
Jesli pracujesz ze specjalistycznymi agentami, dodaj obszary fokusa dla kazdej roli. Agent Frontend powinien znac Twoja biblioteke komponentow. Agent DevOps powinien znac pipeline wdrozen. Agent QA powinien znac framework testowy.
Obszary fokusa i unikania dla kazdej roli
AgentsRoom zostal zbudowany z CLAUDE.md jako centralnym elementem, nie dodatkiem.
Edytuj CLAUDE.md bezposrednio w AgentsRoom z podswietlaniem skladni i automatycznym zapisem. Bez przełączania do edytora tekstu czy IDE.
Obserwuj w czasie rzeczywistym, jak kazdy agent interpretuje Twoj CLAUDE.md. Sledz wyjscie terminala, aby upewnic sie, ze agenci przestrzegaja konwencji i respektuja obszary do unikania.
Kazdy projekt w AgentsRoom ma wlasny plik CLAUDE.md. Przelaczaj sie miedzy projektami, a kazdy agent automatycznie zaladuje odpowiedni plik kontekstowy dla danej bazy kodu.
14 rol agentow w AgentsRoom jest bezposrednio powiazanych z sekcjami CLAUDE.md. Zdefiniuj obszary fokusa i unikania dla kazdej roli, a kazdy agent pobierze dokladnie te instrukcje, ktore sa dla niego przeznaczone.
Pobierz AgentsRoom i uzyj wbudowanego edytora CLAUDE.md, aby dac agentom potrzebny kontekst. Lepsze instrukcje, lepszy kod.
Pobierz AgentsRoomNa zawsze za darmo. Uzyj wlasnego API key.