Jak dać Claude Code wiedzę o firmowych konwencjach kodu

Claude Code

Jak dać Claude Code wiedzę o firmowych konwencjach kodu

W skrócie

Claude Code potrafi napisać działający kod, ale działający to nie to samo co zgodny z konwencją zespołu. Jeśli macie ustalone nazewnictwo, preferowane biblioteki, układ katalogów albo wzorce testów, warto powiedzieć o nich wprost - inaczej narzędzie będzie zgadywać. Pokazujemy, gdzie i jak zapisać firmowe konwencje, żeby Claude Code stosował je sam, bez przypominania w każdej rozmowie.

Jak to wygląda w praktyce

Objaw jest subtelny, bo kod przechodzi testy i wygląda sensownie - tylko nie tak, jak piszecie u siebie. Claude Code używa innej konwencji nazw, sięga po bibliotekę, której u was się unika, układa pliki inaczej niż reszta projektu albo pisze testy w stylu, którego zespół nie stosuje.

Skutek jest taki, że po każdej generacji poprawiasz te same rzeczy ręcznie: przenosisz pliki, zmieniasz nazwy, podmieniasz bibliotekę. To działa, ale marnuje czas, który miał zaoszczędzić sam asystent.

Dlaczego Claude Code tak działa

Claude Code nie zna z góry wewnętrznych standardów Twojej firmy. Gdy nie ma ich zapisanych, wnioskuje konwencje z tego, co widzi w otwartych plikach i w kontekście zadania. To rozsądna heurystyka, ale zawodzi, gdy projekt jest niejednorodny albo gdy akurat pracujecie nad nowym fragmentem, w którym wzorca jeszcze nie widać.

Rozwiązaniem jest pamięć projektu. Claude Code czyta zasady z kilku poziomów: pliku użytkownika w katalogu domowym (wspólnego dla wszystkich Twoich projektów), pliku projektu w repozytorium (współdzielonego z zespołem przez kontrolę wersji) oraz polityki zarządzanej przez firmę, która obejmuje wszystkich w organizacji. Do tego dochodzą pliki reguł, które można zawęzić do konkretnych typów plików lub katalogów. To pozwala opisać konwencje raz i stosować je automatycznie.

Jak to rozwiązać krok po kroku

1. Zbierz konwencje, które chcesz utrwalić: nazewnictwo, preferowane i zakazane biblioteki, układ katalogów, wzorce testów, sposób obsługi błędów, format commitów.
2. Konwencje całego projektu zapisz w CLAUDE.md w korzeniu repozytorium i zacommituj - dzięki temu cały zespół dostaje te same zasady przez kontrolę wersji.
3. Zasady wspólne dla wszystkich Twoich projektów (np. osobiste preferencje stylu) przenieś do ~/.claude/CLAUDE.md, żeby nie powtarzać ich w każdym repozytorium.
4. Standardy obowiązujące całą organizację można wprowadzić jako politykę zarządzaną - plik CLAUDE.md w lokalizacji polityki firmowej, którym zarządza dział IT.
5. Szczegółowe reguły przypisane do jednego języka lub obszaru (np. inny styl w warstwie frontendu niż backendu) wydziel do plików .claude/rules/*.md i zawęź do właściwych typów plików lub katalogów.
6. Pisz reguły konkretnie, najlepiej z krótkim przykładem dobrego i złego kodu, bo jednoznaczna zasada jest łatwiejsza do zastosowania niż ogólnik.
7. Zapisz, uruchom nową sesję i sprawdź przez /memory, że zasady zostały wczytane.

Jak sprawdzić, że zadziałało

Sprawdź na świeżym zadaniu: poproś o nowy moduł albo test i zobacz, czy Claude Code od razu trzyma się nazewnictwa, bibliotek i układu katalogów, które opisałeś. Jeśli tak - konwencje działają.

Gdy część zasad nadal nie jest respektowana, uruchom /memory i potwierdź, że właściwe pliki są wczytane, a następnie sprawdź, czy nie ma między nimi sprzeczności. Reguły zawężone do katalogów zadziałają dopiero, gdy Claude Code pracuje w tym obszarze - zweryfikuj je w odpowiednim miejscu projektu.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5