Praktyczne workflow w Claude Code: Debug, refactor, testy i PR krok po kroku

Masz agenta AI — i co dalej? Claude Code to nie tylko narzędzie do generowania kodu. To partner w codziennych workflow: od eksploracji nieznanych projektów, przez debugowanie, po automatyczne tworzenie pull requestów.

  1. Eksploracja nowego kodu
  2. Debugowanie krok po kroku
  3. Refaktoryzacja bez ryzyka
  4. Pisanie i uruchamianie testów
  5. Tworzenie pull requestów
  6. Wskazówki workflow

Eksploracja nowego kodu {#eksploracja}

Dołączasz do projektu z 200 plikami i zerową dokumentacją. Zamiast przeglądać pliki losowo, zapytaj Claude:

> give me an overview of this codebase

Claude przeanalizuje strukturę katalogów, główne moduły i konwencje. Potem możesz drążyć głębiej:

> explain the main architecture patterns used here
> what are the key data models?
> trace the login process from front-end to database

Wskazówka: Zacznij od szerokich pytań, potem zawężaj. Pytaj o konwencje, wzorce i słownik terminów specyficznych dla projektu. Im więcej kontekstu zbudujesz na początku, tym lepsze odpowiedzi dostaniesz później.

Debugowanie krok po kroku {#debugowanie}

Widzisz błąd przy uruchomieniu testów? Nie przeklejaj stacktrace do Google — przekaż go Claude:

> I am seeing an error when I run npm test

Claude przeczyta stack trace, znajdzie źródło problemu i zaproponuje rozwiązanie:

> suggest a few ways to fix the @ts-ignore in user.ts

Po wybraniu podejścia:

> update user.ts to add the null check you suggested
Dobre praktyki debugowania z Claude Code
PraktykaDlaczego działa
Podaj komendę reprodukującą błądClaude uruchomi ją i zobaczy pełny kontekst
Opisz czy błąd jest stały czy losowyPomaga w diagnozie race conditions
Wskaż co zmieniłeś ostatnioZawęża pole poszukiwań

Refaktoryzacja bez ryzyka {#refaktoryzacja}

Refaktoryzacja starego kodu to ryzykowne zadanie. Claude Code minimalizuje to ryzyko przez Plan Mode — tryb tylko do odczytu, gdzie AI analizuje kod bez wprowadzania zmian.

Włącz Plan Mode przez Shift+Tab (dwukrotnie) lub uruchom:

claude --permission-mode plan

Teraz możesz bezpiecznie planować:

> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.

Claude przeanalizuje obecną implementację i stworzy szczegółowy plan. Doprecyzuj follow-upami:

> What about backward compatibility?
> How should we handle database migration?

Gdy plan jest gotowy, wyjdź z Plan Mode (Shift+Tab) i wykonaj migrację krok po kroku:

> refactor utils.js to use ES2024 features while maintaining the same behavior
> run tests for the refactored code

Więcej o Plan Mode znajdziesz w artykule Plan Mode w Claude Code.

Pisanie i uruchamianie testów {#testy}

Claude Code potrafi zidentyfikować nieprzetestowany kod i wygenerować testy pasujące do konwencji projektu:

> find functions in NotificationsService.swift that are not covered by tests

Po identyfikacji luk:

> add tests for the notification service
> add test cases for edge conditions in the notification service
> run the new tests and fix any failures

Automatyczne dopasowanie stylu: Claude analizuje istniejące pliki testowe i dopasowuje się do frameworka, stylu asercji i konwencji nazewnictwa używanych w projekcie.

Tworzenie pull requestów {#pull-request}

Najszybszy sposób to wbudowany skill:

> /commit-push-pr

Ta komenda commituje zmiany, pushuje branch i otwiera PR w jednym kroku. Jeśli masz skonfigurowany Slack przez MCP, automatycznie wyśle link do odpowiedniego kanału.

Dla większej kontroli, prowadź Claude krok po kroku:

> summarize the changes I have made to the authentication module
> create a pr
> enhance the PR description with more context about the security improvements
Workflow PR w Claude Code
<DataRow cols={["Wznowienie sesji z PR", "claude --from-pr "]} />
KrokKomenda
Podsumowanie zmiansummarize my changes
Commit + push + PR/commit-push-pr
Wzbogacenie opisuenhance the PR description with...

Sesja Claude Code jest automatycznie powiązana z utworzonym PR. Możesz ją wznowić później przez claude --from-pr <number>.

Wskazówki workflow {#workflow-tips}

Używaj subagentów do specjalistycznych zadań. Claude Code automatycznie deleguje odpowiednie zadania do wyspecjalizowanych subagentów:

> review my recent code changes for security issues
> use the code-reviewer subagent to check the auth module

Możesz też tworzyć własnych subagentów dla powtarzalnych workflow — więcej w artykule o subagentach w Claude Code.

Dokumentacja wraz z kodem. Nie zostawiaj dokumentacji na później:

> find functions without proper JSDoc comments in the auth module
> add JSDoc comments to the undocumented functions in auth.js

Iteruj w małych krokach. Zamiast prosić o wielką refaktoryzację na raz, podziel ją na kroki. Każdy krok przetestuj przed przejściem do następnego.

Wdrożenie Claude Code w zespole