Jak pracować z Claude Code w zespole: plan, kolejność i odbiór

Co się zmienia, gdy Claude Code pracuje w zespole

Claude Code czyta kod, zmienia pliki i uruchamia polecenia, a zadanie dostaje opisane zwykłymi słowami. Dopóki pracuje z nim jedna osoba, sama mówi mu w rozmowie to, czego agent nie wyczyta z kodu. Gdy z agentami zaczyna pracować kilka osób naraz, zespół musi odpowiedzieć na trzy pytania.

• Co agent ma zrobić? Gdy zadanie istnieje tylko w wiadomości do agenta, reszta zespołu go nie widzi.
• Kto co robi i w jakiej kolejności? Dwie sesje mogą zacząć tę samą pracę albo pracę, która zależy od czegoś, czego jeszcze nikt nie zrobił.
• Kiedy praca jest skończona? Agent sam zgłasza, że skończył. Zespół musi wiedzieć, kto sprawdza wynik i według czego.

Odpowiedzią są trzy rzeczy, które ustala zespół, a nie agent: plan, kolejność i odbiór.

Zadanie jako plan, a nie wiadomość

Planowanie pracy z agentem AI zaczyna się od tego, gdzie zapisujesz zadanie. Plan to dokument, który opisuje jedną pracę tak, żeby osoba albo agent mogli ją wykonać bez dopytywania. Dobrze sprawdza się w nim kilka stałych części: cel, zakres, kroki, kryteria akceptacji i definicja ukończenia.

Kryteria akceptacji przydają się dwa razy: agent wie z nich, kiedy skończyć, a osoba, która odbiera pracę, wie, co sprawdzić. Co wpisać w każdą z tych części, żeby agent nie musiał zgadywać i sam mógł sprawdzić wynik, opisuje wpis Jak napisać plan, który agent AI zrealizuje bez zgadywania.

Pilnuj rozmiaru planu. Dobrą miarą jest jedna praca, którą jedna sesja agenta zrealizuje w całości. Większy temat podziel na kilka planów i zapisz, który na który czeka.

Plan jest osobnym dokumentem, a nie jedną z wiadomości w rozmowie. Przeczyta go inna osoba, inna sesja agenta i Ty za miesiąc, gdy trzeba będzie sprawdzić, co ustalono. Pracę według takiego dokumentu nazywa się spec-driven development.

Kolejność ustalają osoby

Gdy kilku agentów pracuje równolegle, kolejność przestaje być sprawą jednej osoby. Ekranu z listą faktur nie da się dokończyć, dopóki nie powstanie zapis faktur w bazie. Dwie sesje, które zmieniają ten sam fragment kodu, wchodzą sobie w drogę.

Co pomaga:

1. Zapisz zależności. Przy każdym planie zapisz, na które plany czeka. Wtedy widać, co jest gotowe do podjęcia teraz, a co musi zaczekać.
2. Grupuj plany w epiki. Epik zbiera plany jednego tematu i pokazuje, ile z nich jest już zrobione.
3. Ustaw kolejność gotowych planów. Agent może sam wziąć następny gotowy plan. O tym, który jest następny, decydują osoby: agent widzi zadanie i kod, ale nie widzi priorytetów zespołu, terminów ani rozmów z klientem.
4. Daj każdej sesji osobną kopię kodu. Gdy jedna osoba prowadzi kilka sesji naraz, każda sesja powinna pracować w osobnej kopii roboczej repozytorium, na przykład w git worktree, żeby zmiany się nie zderzały. Jak to ustawić, pokazuje wpis Kilku agentów AI w jednym projekcie.

Wspólne zasady pracy agenta

Każda osoba może pracować z agentem po swojemu: jedna każe pisać testy, druga nie, jedna pozwala agentowi rozszerzyć zakres, druga oczekuje pytania. W zespole zasady warto spisać raz, dla wszystkich, w dwóch miejscach.

• W repozytorium. Claude Code wczytuje plik CLAUDE.md na początku każdej sesji. CLAUDE.md projektu trafia do repozytorium razem z kodem, więc te same zasady dostaje sesja każdej osoby. Wpisz tam to, czego agent nie wyczyta z kodu: polecenia testów, decyzje zespołu, miejsca, w których kod wprowadza w błąd.
• W prompcie roli. Tu opisujesz proces: jak agent bierze pracę, co robi, gdy czegoś brakuje, i co pisze na koniec. Taki tekst to prompt roli.

Prompt roli dla agenta, który realizuje plany, może mówić na przykład: rób tylko to, co jest w planie; gdy plan czegoś nie rozstrzyga, zadaj pytanie, zamiast zgadywać; na końcu napisz, co zrobiłeś, co inaczej niż w planie i dlaczego, a czego nie zrobiłeś. Pytanie i odpowiedź powinny trafić do planu, a nie zostać w jednej rozmowie. Wtedy osoba, która odbiera pracę, wie, co ustalono po drodze.

Odbiór należy do osoby

Agent zgłasza, że skończył, ale to jeszcze nie znaczy, że praca jest przyjęta. Nawet gdy agent pracuje sam, dwie decyzje powinny zostać przy osobie: co znaczy „skończone” i czy wynik jest przyjęty.

Jak odbierać pracę agenta:

• Porównaj wynik z kryteriami akceptacji z planu, a nie z podsumowaniem agenta.
• Poproś agenta o dowód, czyli polecenie, które uruchomił, i jego wynik.
• Przeczytaj, co agent zrobił inaczej niż w planie i dlaczego.
• Przyjmij albo odrzuć pracę. Gdy odrzucasz, napisz powód, żeby agent wiedział, co poprawić.
• Odbieraj na bieżąco. Gdy plany długo czekają na decyzję, poprawka przychodzi późno, a na odrzuconej pracy mogą już opierać się kolejne plany.

Odbiór nie zastępuje testów ani przeglądu kodu. Odpowiada na inne pytanie: czy powstało to, o co prosił plan. Taki podział ról, w którym agent pracuje sam, a w ważnych punktach decyduje osoba, nazywa się human-in-the-loop.

Jak zacząć w zespole

1. Wybierz jedno miejsce na plany dla całego zespołu i jeden wzór planu.
2. Rozpisz jeden temat na kilka małych planów z kryteriami akceptacji i zależnościami.
3. Spisz polecenia testów w CLAUDE.md, a zasady pracy agenta w prompcie roli.
4. Umów się z zespołem, że plany bierzecie po kolei, a każda sesja agenta pracuje w osobnej kopii kodu.
5. Odbieraj każdy plan i zapisuj powód, gdy go nie przyjmujesz.
6. Po kilku tygodniach sprawdź, które plany wracały do poprawek i czego w nich brakowało. Popraw wzór planu albo prompt roli.

Jak to wygląda w featureloom

featureloom to tablica planów, do której każda osoba w zespole podłącza swoje Claude Code, Codex albo Cursor. Plan jest tam dokumentem w markdownie na tablicy kanban, a całość wygląda tak:

• Plan. Według szablonu planu featureloom generuje plany w aplikacji, a agenci piszą je w konsoli. Wbudowany szablon prosi między innymi o cel, zakres, kroki, kryteria akceptacji i definicję ukończenia. Dopasujesz go na ekranie Ustawienia projektu, w zakładce Szablon planu.
• Kolejność. Zależność Czeka na… mówi, który plan musi być zrealizowany wcześniej, a ekran Kolejność pokazuje, co jest gotowe do podjęcia. Agent dostaje następny plan w kolejności tablicy: taki, który na nic nie czeka i za który nie odpowiada ktoś inny. Planu, który czeka, konsola nie rozpocznie, a dwie konsole nie podejmą tego samego planu. Karta pokazuje, kto i którą konsolą realizuje plan. Szczegóły znajdziesz w samouczku Epiki i Kolejność.
• Zasady pracy. Prompty organizacji działają w Claude Code, Codex i Cursorze jak komendy. Każda nowa organizacja ma gotowy prompt Realizator: zawiera zasady z przykładu wyżej, a kolumny, kolejność i odbiór zostawia osobom. Polecenie featureloom realizator FAK-14 daje agentowi ten prompt, cały plan FAK-14 i dokumenty zrealizowanych planów, od których FAK-14 bezpośrednio zależy. Jak pisać własne prompty, pokazuje samouczek Prompty ról.
• Pytania. Agent pyta w planie, a Ty odpowiadasz na ekranie planu przyciskiem Odpowiedz. Pytanie i odpowiedź zostają w dokumencie planu. Więcej w samouczku Pytania agenta i Twoje odpowiedzi.
• Odbiór. W części Odbiór naciskasz Przyjmuję albo Nie przyjmuję, a w polu Powody (opcjonalnie) możesz dopisać, dlaczego. Werdykt wydaje tylko osoba w aplikacji. Po odrzuceniu agent czyta werdykt i wraca do poprawek, co pokazuje samouczek Odbiór: Nie przyjmuję i poprawki agenta. Na ekranie Raporty część Czeka na odbiór wymienia najpierw najstarsze plany bez decyzji.

featureloom nie łączy się z Twoim kodem, więc osobne kopie repozytorium, testy i przegląd zmian zostają po stronie zespołu. Na początek administrator otwiera ekran Osoby i zaprasza zespół przyciskiem Zaproś osobę, jak w samouczku Zaproś osoby i nadaj prawa. Potem każda osoba otwiera Integracje i na karcie Twoje konsole łączy swoją konsolę, jak w samouczku Podłącz Claude Code jednym poleceniem.