Przejdź do głównej zawartości

Onboarding i adopcja w zespole, pętla po pętli

Adopcja agentów kodujących w zespole to rozszerzanie jednej sprawdzonej praktyki z kilku inżynierów na cały zespół, jedna pętla naraz. Każda pętla ma właściciela, który wdraża kolegów na jej obecnym poziomie autonomii. Adopcję mierzy się efektywnym użyciem: odsetkiem uprawnionych inżynierów, którzy domykają pętlę na granicy dowodów, gdy awarie zmian zostają na poziomie bazowym (baseline).

Ta strona jest dla tech leada, który prowadzi wdrożenie, i dla CTO, który pyta, czy się udało. Wiosną dałeś dostęp dwunastu inżynierom. Dwóch z nich co tydzień puszcza przez agenta aktualizacje zależności, jeden senior przestał po jednym złym pull requeście, a reszta używa go do podpowiedzi. Na ostatnim retro ktoś powiedział, że wcześni użytkownicy „dowożą dużo szybciej”, i nikt nie umiał powiedzieć, jak to zmierzono ani ile kosztowało to kolejkę review.

  • Regułę wyboru pierwszej pętli, którą zespół przyjmuje, i imiennego właściciela pętli zamiast „sieci championów”.
  • Wspólny harness, który czyta agent każdego inżyniera, zsynchronizowany między Claude Code, Codex i Cursorem.
  • Sekwencję onboardingu, która prowadzi jednego inżyniera od dostępu do policzonego ukończenia w dwóch prawdziwych zadaniach.
  • Osobne reguły rozszerzania pętli na kolejne osoby i wspinania się pętli na następny szczebel drabiny, razem z tym, kto je podpisuje.
  • Miarę efektywnego użycia z promptem, który liczy ją ze zmergowanych pull requestów, oraz tryby awarii, przez które liczby adopcji kłamią.

Dlaczego adopcja pętlami, a nie według krzywej adopcji?

Dział zatytułowany „Dlaczego adopcja pętlami, a nie według krzywej adopcji?”

Samo używanie już nie odróżnia zespołów. Raport DORA 2025 podaje, że „90% of survey respondents report using AI at work” (Google Cloud, 23 września 2025). Centralny wniosek tego samego raportu to powód, żeby przestać liczyć użytkowników: „AI doesn’t fix a team; it amplifies what’s already there”. Zespół, który rozszerza użycie agentów bez testów, limitów review i wspólnego kontekstu, dostaje więcej nieprzejrzanych zmian, a nie więcej dostarczonej wartości.

Poziom należy też do pętli, a nie do osoby ani zespołu. Jedna mapa definiuje pętlę jako powtarzalną klasę zmian z własnym wyzwalaczem, wyrocznią i warunkiem stopu, na przykład aktualizacje zależności, naprawę niestabilnych testów albo pracę nad funkcjami w jednym serwisie. Ten sam inżynier może jednego dnia prowadzić aktualizacje zależności na L4 i integrację z operatorem płatności na L2, i oba poziomy są poprawne.

Przełóż starsze schematy wdrożenia na pętle, a potem je wycofaj:

Wycofany schematCo miał załatwićCo go zastępuje
Krzywa adopcji (championi, wcześni użytkownicy, większość, maruderzy)Tempo wdrożenia wyznaczane przez ludziRozszerzanie jednej pętli naraz, z właścicielem i listą uprawnionych dla każdej pętli
Wspólna podstawa „Faza 0”Powstrzymanie rozjazdu konwencji między narzędziamiWspólny harness opisany niżej, z kryterium wyjścia
Modele według wielkości organizacji (2–10, 10–50, 50+) ze stałymi tygodniamiRozpisanie kalendarzaTempo wyznacza liczba pętli i zespołów; przy wielu zespołach projekt pilotażu
Trzy poziomy szkoleńNauka funkcji narzędzia według stażuPodnoszenie kompetencji per przejście po drabinie
Aktywni użytkownicy, sesje dziennieDowód adopcjiEfektywne użycie w każdej pętli, z metrykami ochronnymi

Zbuduj jeden wspólny harness, zanim ktokolwiek zacznie onboarding

Dział zatytułowany „Zbuduj jeden wspólny harness, zanim ktokolwiek zacznie onboarding”

Onboarding się sypie, gdy agent każdego inżyniera czyta inny kontekst. Zanim pierwsza osoba dołączy do pętli, zacommituj jeden plik instrukcji wygenerowany z prawdziwego repozytorium. Playbook konwersji projektu opisuje pełną konfigurację; tu jest minimum.

Uruchom claude w katalogu głównym repozytorium i wklej:

Explore this repository and write a CLAUDE.md at the root. Capture our stack,
the exact install, build, typecheck, lint and test commands, our branch and
PR conventions, and the conventions a new engineer most often gets wrong.
Bullet points only, under 60 lines. Then run each command you listed and
report which pass on the default branch. Finally, list which rules an
automated check could enforce, so they move into CI instead of prose.

W dużym monolicie dopisz „use subagents to survey each top-level directory”, żeby eksploracja nie wyczerpała kontekstu głównej sesji. Claude Code czyta też AGENTS.md, gdy projekt nie ma CLAUDE.md, od v2.1.277 w sesjach first-party i od v2.1.281 na Bedrock, Google Cloud, Foundry, bramkach LLM albo z wyłączoną telemetrią, w obu przypadkach na kanale latest (kanał stable był 26 września 2026 na v2.1.274). Sprawdź kanał swoich inżynierów, zanim zaczniesz na tym polegać.

Kryterium wyjścia harnessu jest mechaniczne: świeży klon przechodzi typecheck, lint i testy dokładnie tymi komendami, które wymienia plik instrukcji. Zespoły korzystające z więcej niż jednego narzędzia muszą potem pilnować, żeby pliki się zgadzały.

Uruchamiaj prompt synchronizacji przy każdej zmianie któregoś z plików. Wspólne skille i hooki podlegają tej samej zasadzie: jedna zacommitowana kopia, przeglądana jak kod (wspólne skille).

Wybierz pętlę, której wynik już ocenia twoja platforma hostingu kodu i CI, żeby ukończenie liczył system, a nie osoba, która je wykonała.

KryteriumDobra pierwsza pętlaSłaba pierwsza pętla
WolumenCo najmniej pięć zmergowanych zmian miesięcznie, żeby 30-dniowe okno zawierało dowodyMigracja raz na kwartał
WyroczniaO „gotowe” decyduje test, sprawdzenie typów albo test kontraktowy„Recenzentowi wygląda dobrze”
Klasa ryzykaNiska lub średnia: testy, narzędzia wewnętrzne, łatki zależnościUwierzytelnianie, płatności, migracje schematu na danych produkcyjnych
Zasięg awariiJeden serwis, odwracalny przez revertWspólne biblioteki importowane przez wszystkie zespoły
LudzieCo najmniej dwóch inżynierów robi tę pracę co tydzieńJeden specjalista zajmuje się tym sam

Naprawa niestabilnych testów, aktualizacje zależności i poprawki padających testów zwykle spełniają wszystkie pięć kryteriów. Zapisz pętlę, jej obecny poziom i właściciela w pliku loops.yaml w repozytorium; mapa adopcji opisuje format rejestru.

Właściciel pętli zastępuje dawnego „championa”: odpowiada za dowody jednej pętli, a nie za ewangelizowanie narzędzia. Wybierz osobę, którą szanują koledzy i która dobrze tłumaczy, a nie najgłośniejszego wczesnego entuzjastę.

  • Przechodzi pętlę pierwszy i zapisuje problemy we wpisie pętli.
  • Pracuje w parze z każdym kolegą przy jego pierwszym zadaniu w pętli.
  • Dba o wspólny harness pętli: instrukcje, skille i listę zadań onboardingowych.
  • Raportuje zmierzone wyniki na spotkaniach zespołu: ukończenia, zaakceptowane zmiany i awarie, nigdy anegdoty.
  • Przekazuje tarcia tech leadowi, sklasyfikowane, żeby zespół naprawiał najpierw najczęstszą klasę.

Ogranicz czas wsparcia właściciela i zmieniaj osobę, gdy pętla osiąga kolejny poziom.

Onboarding to dwa prawdziwe zadania z backlogu, a nie warsztat na zabawkowym projekcie. Kończy się, gdy inżynier liczy się do efektywnego użycia.

  1. Dostęp i polityka. Zarządzane konto, zaakceptowana polityka użycia zespołu i działająca konfiguracja, która czyta wspólny harness. W Codex obejmuje to oznaczenie repozytorium jako zaufanego (akceptacja pytania przy pierwszym uruchomieniu codex w repozytorium). Nikt w pętli nie dostaje poświadczeń produkcyjnych przez agenta.

  2. Przeczytaj pętlę, nie instrukcję narzędzia. Inżynier czyta wpis pętli w loops.yaml i jej kartę adopcji: które zadania się kwalifikują, co liczy się jako ukończenie i które ścieżki są wyłączone.

  3. Pierwsze zadanie, w parze. Właściciel i inżynier biorą jedno kwalifikujące się zadanie z backlogu i wykonują je na obecnym poziomie pętli. Zadanie kończy się na granicy dowodów: zmergowany pull request z zielonymi wymaganymi checkami.

  4. Drugie zadanie, samodzielnie. Inżynier wykonuje drugie kwalifikujące się zadanie sam. Właściciel przegląda pull request tak samo jak każdy inny w tej pętli, nie surowiej.

  5. Policzony. Dopisz inżyniera do eligible.txt z datą zakończenia onboardingu. Wchodzi do mianownika efektywnego użycia tej pętli w każdym oknie, które zaczyna się tego dnia lub później, a do licznika w każdym takim oknie, w którym ma ukończenie. Liczenie od początku okna sprawia, że osoba dołączająca w trakcie nie zaniża wyniku okna, w którym nie mogła niczego ukończyć, a dwa PR z onboardingu nigdy nie liczą się jako ukończenia. Czas onboardingu deweloperów zamienia kroki 1–3 w mierzony scenariusz dla nowych pracowników.

To, czego uczy się nowa osoba, zależy od poziomu pętli, a nie od jej stażu:

Poziom pętliCo robi nowa osobaCo człowiek czyta przed merge’emCo właściciel sprawdza przy pierwszym zadaniu
L2 W parzeSteruje agentem na żywo i odpowiada na prośby o uprawnieniaNowa osoba czyta każdą edycję na bieżącoZadanie nie wyszło poza kwalifikujące się ścieżki
L3 Menedżer reviewUruchamia nienadzorowany przebieg w worktree lub sandboksie, potem przegląda diffRecenzent czyta każdy diffPrzebieg korzystał ze wspólnego harnessu, a lokalne testy przeszły przed PR
L4 Menedżer specyfikacjiPisze albo akceptuje specyfikację i kryteria akceptacji, potem czyta pakiet dowodówSpecyfikację i pakiet dowodów; kod tylko w klasach ryzyka wysokiego i krytycznegoTesty i pliki CI są nietknięte, a pakiet zgadza się z kryteriami akceptacji

Pętla zmienia się na dwa niezależne sposoby. Rozszerzanie dodaje ludzi na tym samym poziomie. Wspinanie się przesuwa pętlę na kolejny szczebel drabiny. W jednym oknie pomiarowym zmieniaj jedno albo drugie, nigdy oba naraz, bo inaczej nie ustalisz, która zmiana spowodowała awarię.

ZmianaIdziemy dalej, gdyZatrzymujemy lub cofamy, gdyKto podpisuje
Rozszerzenie na kolejną grupę inżynierówEfektywne użycie wśród obecnych uprawnionych jest stabilne przez jedno okno, a poprawki następcze i awarie zmian są na poziomie bazowym lub niżejCzas do pierwszego review przekracza limit zespołu albo poprawki następcze rosną ponad poziom bazowyTech lead
Wspinanie się L2 → L3Przebiegi kończą się bez nadzoru w izolowanych checkoutach, a recenzenci nadążają z każdym diffemRecenzenci zaczynają zatwierdzać bez czytania; kolejka review rośnie z tygodnia na tydzieńTech lead
Wspinanie się L3 → L4Chronione testy, pakiet dowodów przy każdym PR i zaliczony audyt próbkiPR z próbki zmienił własne testy albo rośnie odsetek revertów w pętliTech lead razem z code ownerem odpowiednich ścieżek
Wspinanie się L4 → L5Klasy niskiego ryzyka mergują się automatycznie według reguły, a ścieżka wycofania zadziałała w ćwiczeniuJakikolwiek incydent spowodowany przez pętlę w danym oknieTech lead i CTO, który odpowiada za politykę klas ryzyka

Mechanika każdego przejścia (worktree, chronione testy, bramki dowodowe, reguły auto-merge) jest opisana w mapie adopcji. Ludzką stronę przejścia z review diffów na review dowodów opisuje transfer zaufania.

UkładIle pętli zmienia się narazCo je koordynuje
Jeden zespółJedna pętla rozszerza się albo wspina w danym momencieTech lead i jeden właściciel pętli
Kilka squadów na wspólnej bazie koduJedna pętla na squad, każda z własnym właścicielemJeden wspólny rdzeń harnessu; wpisy pętli per squad w loops.yaml
Wiele zespołówPętle pilotażowe w dwóch–trzech zespołach w porównaniu z dopasowanymi zespołami, które pracują po staremuPodpisana reguła decyzyjna z projektu pilotażu, potem mapa transformacji organizacji

Mierz efektywne użycie osobno dla każdej pętli, według definicji z mierzenia efektywnego użycia workflow:

efektywne użycie (pętla, okno) = uprawnieni inżynierowie z ≥ 1 ukończeniem na granicy dowodów
÷ uprawnieni inżynierowie z dostępem i ukończonym onboardingiem

Granica dowodów to zmergowany pull request z zielonymi wymaganymi checkami, którego w ciągu 14 dni nie cofnięto revertem ani nie poprawiano kolejną zmianą. Zestaw tę liczbę z metrykami ochronnymi z ram metryk: 14-dniowym odsetkiem poprawek następczych, wskaźnikiem awarii zmian i czasem do pierwszego review, każdą w porównaniu z poziomem bazowym sprzed wdrożenia dla tego samego typu zadań. Raport DORA 2025 (Google Cloud, 23 września 2025) wyjaśnia, dlaczego metryki ochronne są obowiązkowe: „we observe a positive relationship between AI adoption on both software delivery throughput and product performance”, a w następnym zdaniu: „AI adoption does continue to have a negative relationship with software delivery stability”. Raportuj dla każdej pętli i każdego zespołu, nigdy dla pojedynczych inżynierów.

Żeby liczenie było mechaniczne, oznaczaj każdy pull request etykietą pętli (loop:flaky-test-repair) i etykietą agent-assisted z szablonu PR. Okno to 30 dni kończące się 14 dni temu, więc każde ukończenie miało 14 dni na revert albo poprawkę. Wyeksportuj zmergowane pull requesty z ostatnich 44 dni w terminalu, w katalogu głównym repozytorium:

Okno terminala
# GNU date (Linux); na macOS użyj: date -v-44d +%F
SINCE=$(date -d '44 days ago' +%F)
gh pr list --state merged --search "merged:>=$SINCE" --limit 1000 \
--json number,title,author,labels,mergedAt,body,statusCheckRollup > merged-prs.json

Zapisz poniższy prompt jako prompts/effective-use.txt, wypisz uprawnionych inżynierów w eligible.txt (jeden wiersz login pętla onboarded-RRRR-MM-DD na inżyniera i pętlę, bo każda pętla ma własną listę uprawnionych) i uruchom go w trybie tylko do odczytu:

Okno terminala
claude -p "$(cat prompts/effective-use.txt)" --tools "Read" --strict-mcp-config > effective-use.md

--tools "Read" usuwa wszystkie inne wbudowane narzędzia, a --strict-mcp-config pomija serwery MCP projektu, więc sam agent nie ma narzędzia, które edytuje pliki lub uruchamia polecenia. Hooki z plików ustawień nadal się wykonują, więc jeśli projekt definiuje hooki, dodaj --setting-sources user (albo uruchom to na czystym klonie). --setting-sources user nadal wczytuje hooki użytkownika i wtyczek; --safe-mode wyłącza też hooki, wtyczki i serwery MCP (Claude Code 2.1.283).

Żeby sprawdzić wynik, wylosuj trzy ukończenia i trzy wykluczone PR i potwierdź każdy w GitHubie lub innej platformie hostingu kodu. Jeśli choć jeden z sześciu się nie zgadza, popraw etykiety albo prompt, zanim zaraportujesz liczbę.

Zanim pętla wyjdzie poza pierwszych inżynierów, uzgodnijcie, co sprawdza recenzent, i niech pull request to niesie. Na L3 recenzent wciąż czyta każdy diff; na L4 czyta specyfikację i pakiet dowodów, a kod tylko w klasach ryzyka wysokiego i krytycznego. Najpierw niech zadziała agent review według tego samego standardu: /code-review w Claude Code, /review albo codex review w Codex, albo agent Cursora z dołączonym standardem. Review PR przez agenta opisuje, jak wpiąć go w CI. Merge nadal należy do człowieka.

Każde sprawdzenie, które prompt oznaczy jako wymuszalne, trafia do CI, zanim pętla się rozszerzy. Sprawdzenie, o którym człowiek musi pamiętać, jako pierwsze przestaje być wykonywane.

Traktuj każdy zarzut jako lukę w dowodach pętli i zamykaj ją sprawdzeniem, a nie argumentem.

ZarzutLuka w dowodachCo zrobić
„Bez tego jestem szybszy”.Brak zmierzonego porównania na zadaniach tej osobyPrzeprowadź dopasowany pilotaż na jej własnych zadaniach; sceptycy i seniorzy zawiera dziennik pilotażu i uczciwą lekturę wyników METR
„Kod od agenta jest zły”.Pętla nie ma wyroczni, której agent nie może edytowaćOddaj seniorowi odpowiedzialność za sprawdzenia pętli; pętla wspina się dopiero, gdy te sprawdzenia trzymają
„On nie rozumie naszej bazy kodu”.Agent inżyniera nie czyta wspólnego harnessuPoproś agenta o zacytowanie pierwszej reguły z CLAUDE.md albo AGENTS.md; jeśli nie potrafi, plik się nie wczytuje. W Codex sprawdź też, czy repozytorium jest zaufane: jego ścieżka ma trust_level = "trusted" w ~/.codex/config.toml
„Obecny sposób pracy działa”.Nikt nie widział obu sposobów pracy na tym samym zadaniuPrzez jedno okno prowadź stary sposób obok pętli i porównaj oba na metrykach ochronnych
„To mnie zastąpi”.Brak wypowiedzianej wizji roliPowiedz, czym staje się praca zespołu: specyfikowaniem i weryfikowaniem zachowania; zobacz warsztat i karierę

Nie narzucaj narzędzia pierwszego dnia. Wymuszona adopcja produkuje sesje, które istnieją po to, żeby zadowolić dashboard, i zaśmieca mianownik efektywnego użycia.

  • Adopcja staje po pierwszych inżynierach. Zwykle brakuje harnessu albo właściciela w każdym squadzie, więc każda nowa osoba zaczyna od zera. Sprawdź kryterium wyjścia harnessu na świeżym klonie i wyznacz jednego właściciela na pętlę.
  • Konwencje rozjeżdżają się między narzędziami. CLAUDE.md, AGENTS.md i Rules w Cursorze mówią co innego, więc wynik zależy od tego, kto prowadzi. Uruchom prompt synchronizacji, zrób z jednego pliku źródło prawdy i dodaj check w CI, który pada, gdy pliki-wskaźniki zmieniają się bez niego.
  • Jeden zły PR od agenta podkopuje zaufanie do pętli. Cofnij go revertem, dodaj do CI sprawdzenie, które by go złapało, i wstrzymaj rozszerzanie na jedno okno. Nie wstrzymuj całego zespołu: dowody pozostałych pętli nadal są ważne.
  • Właściciel pętli zamienia się w helpdesk. Odpowiedzi żyją na czacie, więc pytania się powtarzają. Przenieś każdą powtarzającą się odpowiedź do pliku instrukcji albo wspólnego skilla i zmień właściciela.
  • Kolejka review rośnie. Rozszerzanie dodało autorów szybciej niż recenzentów. Ustaw zespołowy limit otwartych pull requestów od agentów według limitów kolejki review i wstrzymaj rozszerzanie, aż czas do pierwszego review wróci do poziomu bazowego.
  • Liczby, których nikt nie zmierzył. „Wydaje się szybciej” albo liczba przyspieszenia, której nikt nie umie prześledzić, upada przy pierwszym „jak to zmierzono?”. Odtwórz 12-tygodniowy poziom bazowy z platformy hostingu kodu i raportuj efektywne użycie z metrykami ochronnymi albo nie raportuj nic.
  • Rozszerzanie i wspinanie w tym samym oknie. Awarie rosną i nikt nie wie dlaczego. Cofnij wspinanie, zostaw rozszerzenie i od tej pory zmieniaj jedną rzecz na okno.
  • Materiały szkoleniowe się starzeją. Ucz bramek i dowodów pętli, które zmieniają się wolno, i wyznacz osobę, która śledzi zmiany w narzędziach (nadążanie za zmianami).

Zacznij od hubu wdrożenia zespołowego, jeśli repozytorium nie jest jeszcze przygotowane. Następnym krokiem, gdy pierwsza pętla się rozszerzy, jest mapa adopcji repozytorium.