Claude Code: najlepsze praktyki przy dużych refaktorach i architekturze
Jak prowadzić Claude Code przez duże repozytorium bez chaosu: CLAUDE.md, Plan Mode, subagenci, weryfikacja i kontrola kontekstu.
Zacznij od CLAUDE.md, nie od promptu
Największy błąd przy pracy z Claude Code to traktowanie go jak czatu. Przy większym repozytorium agent musi dostać stały kontekst: czym jest projekt, jaki ma stack, jakie są komendy build/test/deploy i czego nie wolno robić.
Plik CLAUDE.md w root projektu działa jak instrukcja operacyjna. Powinien być krótki, konkretny i aktualny. Jeśli ma 500 linii, staje się śmietnikiem. Jeśli ma mniej niż 200 linii i zawiera reguły projektu, Claude częściej robi właściwe rzeczy bez dopytywania.
- •Opis produktu i domeny biznesowej.
- •Stack technologiczny i architektura modułów.
- •Komendy testów, lintingu, builda i deploymentu.
- •Konwencje kodowania, bezpieczeństwa i pracy z sekretami.
Plan Mode na małe zmiany, BMAD na grube ryzyko
Plan Mode wystarcza, gdy robisz jedną funkcję, poprawkę błędu albo lokalny refactor. Dobry cykl to: explore, plan, implement, verify. Najpierw agent czyta kod, potem proponuje plan, dopiero na końcu dotyka plików.
Przy większych projektach, integracjach, user flows i bezpieczeństwie potrzebny jest cięższy proces. BMAD albo podobny model analizy wymusza myślenie o użytkownikach, ryzykach i metrykach zanim zacznie się kodowanie.
- •Małe zadanie: Plan Mode i jedna weryfikacja.
- •Duży moduł: osobny plan architektury, ryzyka i testy regresji.
- •Zmiana z klientami lub danymi: najpierw flows i edge case'y, potem kod.
Kontekst, subagenci i weryfikacja
Claude Code jest mocny w architekturze, ale nadal wymaga higieny kontekstu. Używaj czyszczenia między zadaniami, kompaktowania po długich sesjach i osobnych subagentów do researchu, code review albo security review.
Nie kończ zadania na wygenerowanym kodzie. Kończysz dopiero po testach, lintingu, buildzie albo screenshot verification. To jest różnica między demo a pracującym systemem.
- •Podawaj konkretne pliki zamiast ogólnego opisu.
- •Dziel duże zadania na worktree albo osobne sesje.
- •Wymagaj dowodu: wynik testu, diff, screenshot, log.
Mapa SEO
Najważniejsze ścieżki dla firm szukających AI, KSeF i automatyzacji
Zamiast przypadkowych linków mamy architekturę: usługi główne, klastry tematyczne, artykuły i wybrane strony lokalne. To wzmacnia strony, które realnie mogą przyprowadzać leady.
AI, automatyzacja i KSeF — najważniejsze ścieżki
Te strony są spięte jako główne klastry SEO. Prowadzą od problemu biznesowego do usługi, artykułów i kontaktu.
Strony komercyjne i long-tail
Wybrane strony pod frazy z intencją zakupową. Nie indeksujemy całego śmietnika — indeksujemy te, które mają sens biznesowy.
Lokalne strony pilotażowe
To kontrolowany test lokalnego SEO. Indeksujemy tylko miasta i usługi, gdzie treść ma największą szansę dowieźć leady.