Jak pisać dobry CLAUDE.md

CLAUDE.md to plik z instrukcjami dla Claude Code, który można umieścić na różnych poziomach, zależnie od tego, kogo i jak szeroko mają dotyczyć zasady. Projektowy plik umieść jako ./CLAUDE.md albo ./.claude/CLAUDE.md; jego treść jest przeznaczona dla wszystkich pracujących nad projektem. Warto opisać w nim polecenia budowania i testowania, standardy kodowania, decyzje architektoniczne, nazewnictwo oraz typowe przepływy pracy.

Dobry punkt startowy możesz wygenerować poleceniem /init, które analizuje repozytorium i tworzy plik z rozpoznanymi poleceniami oraz konwencjami projektu. Jeśli CLAUDE.md już istnieje, /init proponuje ulepszenia zamiast go nadpisywać. Po wygenerowaniu uzupełnij plik o instrukcje, których Claude nie wywnioskuje samodzielnie.

Formułuj wskazówki konkretnie: precyzyjna reguła, taka jak Use 2-space indentation, działa lepiej niż ogólne polecenie dbania o formatowanie. Jeśli projekt ma różne instrukcje dla części repozytorium, możesz rozdzielić je na pliki tematyczne i ograniczyć do typów plików lub podkatalogów. Claude łączy znalezione pliki z hierarchii katalogów w kontekście, zamiast traktować je jako pliki, które wzajemnie się nadpisują.

Położenie ma znaczenie: pliki z katalogów nadrzędnych są wczytywane przy uruchomieniu, a instrukcje w podkatalogach dopiero wtedy, gdy Claude pracuje z plikiem w danym podkatalogu. Instrukcje w CLAUDE.md wpływają na zachowanie Claude, ale nie gwarantują ścisłego wykonania, szczególnie gdy są niejasne albo sprzeczne. Po zapisaniu pliku sprawdź /context, aby potwierdzić, że pojawia się na liście Memory files.

# CLAUDE.md
Use 2-space indentation

See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md