Praca ręczna w trakcie sprintu

Jak dyspozytor traktuje ticket bez sesji w tle?

Dyspozytor przy każdym ticku czyta wszystkie tickety aktywnego sprintu i listę sesji w tle na komputerze, na którym działa. Twojej sesji interaktywnej na tej liście nie ma. Ticket, nad którym pracujesz ręcznie, wygląda więc dla niego jak ticket bez sesji.

Z tej tabeli wynikają trzy zasady, na których opiera się reszta wpisu.

1. Status W trakcie bez sesji w tle oznacza dla dyspozytora awarię

   Komenda work uruchomiona ręcznie ustawia ten status, więc następny tick wystartowałby drugą sesję nad tym samym ticketem.

2. Status Review jest bezpieczny

   Dyspozytor nie rusza ticketu, który czeka na merge.

3. Ticket spoza sprintu jest niewidoczny

   Dyspozytor czyta wyłącznie tickety przypisane do aktywnego sprintu.

flowchart TD
  A["Chcę zrobić ticket sprintu ręcznie"] --> B{"Pętla dyspozytora działa?"}
  B -- "tak, ma działać dalej" --> C["Odepnij ticket od sprintu"]
  B -- "mogę ją zatrzymać" --> D["Zatrzymaj pętlę dyspozytora"]
  C --> E["Pracuj w osobnym katalogu roboczym"]
  D --> E
  E --> F["Ticket ma status Review"]
  F --> G["Przypnij ticket do sprintu albo uruchom pętlę"]

Jak zrobić ręcznie ticket z etykietą needs-local?

Ticket z tą etykietą wymaga Twojego komputera albo Twojej decyzji, więc dyspozytor go pomija i wypisuje w raporcie z poleceniem do uruchomienia. Poniższa kolejność działa przy włączonych pętlach.

1. Odepnij ticket od sprintu

   W panelu wyczyść pole sprintu w edycji ticketu albo użyj CLI. Status zostaw na Do zrobienia, bo za chwilę zaczynasz pracę. Status Backlog ustawiasz tylko wtedy, gdy ticket porzucasz albo odkładasz, jak we wpisie o sytuacjach awaryjnych.

2. Utwórz osobny katalog roboczy

   Odgałęź branch ticketu od brancha sprintu. Nazwa brancha ma zawierać numer ticketu.

3. Uruchom komendę w tym katalogu

   Ustaw MONOLYNX_MR_TARGET na branch sprintu, żeby merge request trafił tam, gdzie pozostałe.

4. Przypnij ticket z powrotem

   Gdy komenda ustawi status Review, przypisz ticket do sprintu. Dyspozytor policzy go jako skończony, a kolejka sama przejmie merge request.

$ monolynx --project sklep ticket update SKL-15 --sprint ""

$ git fetch origin
$ git worktree add --no-track -b SKL-15-import-cennika ../sklep-SKL-15 origin/sprint/platnosci
$ cd ../sklep-SKL-15
$ export MONOLYNX_MR_TARGET=sprint/platnosci
$ claude
> /monolynx:work SKL-15

# po statusie Review
$ monolynx --project sklep sprint list
$ monolynx --project sklep ticket update SKL-15 --sprint <id sprintu>

W osobnym katalogu roboczym komenda work bierze komendy lintu i testów z sekcji ## Worktree strony toolchain, tak samo jak sesja w tle.

Druga droga: zatrzymana pętla dyspozytora

Gdy w sprincie zostały same tickety do pracy ręcznej, prościej zatrzymać pętlę dyspozytora: zamknij sesję, w której działa /loop. Kolejka merge requestów może działać dalej. Ticket zostaje wtedy w sprincie przez cały czas, a pętlę uruchamiasz ponownie, gdy ticket ma status Review.

Co zrobić, gdy recenzent odrzucił merge request?

Ticket z odrzuconym merge requestem ma status Review i tak ma zostać. Zmienia się tylko branch ticketu. Sesji, która go napisała, zwykle już nie ma: dyspozytor po zebraniu wyniku usuwa sesję razem z jej katalogiem roboczym. Branch zostaje na serwerze.

1. Przenieś uwagi do ticketu

   Agent nie czyta komentarzy w merge requeście. Wklej je do komentarza ticketu, żeby zostały w historii.

2. Pobierz branch ticketu do osobnego katalogu

   Sesje w tle nazywają branch worktree-<klucz>.

3. Popraw

   Ręcznie albo w zwykłej sesji Claude Code, której opisujesz uwagi recenzenta jednym poleceniem.

4. Wypchnij zwykłym pushem

   Bez wymuszania i bez przepisywania historii.

5. Poczekaj na kolejkę

   Nowy commit uruchamia CI od nowa, a kolejka pyta o zatwierdzenie jeszcze raz, bo zgoda dotyczyła poprzedniego commita.

6. Usuń katalog roboczy

   Po merge nie jest już potrzebny.

$ git fetch origin
$ git worktree add ../sklep-SKL-12 worktree-SKL-12
$ cd ../sklep-SKL-12

# poprawki, potem:
$ git add -A
$ git commit -m "SKL-12: uwagi z recenzji"
$ git push origin worktree-SKL-12

# po merge
$ cd ../sklep
$ git worktree remove ../sklep-SKL-12

Jak odświeżyć branch sprintu z gałęzi głównej?

Branch sprintu, który żyje dłużej niż kilka dni, rozjeżdża się z gałęzią główną: ktoś merguje tam poprawkę albo inną pracę. Im później to wyrównasz, tym większy konflikt w końcowym merge requeście.

1. Stań w głównym katalogu

   Jest na branchu sprintu i jest czysty, bo tak pracują pętle.

2. Wciągnij gałąź główną zwykłym merge

   Konflikt rozwiązujesz tak jak każdy inny.

3. Wypchnij

   Od tej chwili nowe sesje ticketów startują z odświeżonego brancha.

4. Zostaw otwarte merge requesty kolejce

   Te, które po odświeżeniu mają konflikt, kolejka naprawi sama: wciągnie branch sprintu do brancha ticketu.

$ git branch --show-current
sprint/platnosci

$ git fetch origin
$ git merge origin/main
$ git push

Jak zmienić wiele ticketów naraz?

Plan sprintu to często kilkanaście ticketów do przypisania i przestawienia na Do zrobienia. W panelu robisz to wiersz po wierszu, a w terminalu jedną komendą.

$ monolynx --project sklep sprint list
$ monolynx --project sklep ticket bulk-update SKL-12 SKL-13 SKL-14 \
    --sprint <id sprintu> --status todo

Komenda przyjmuje klucze albo identyfikatory ticketów, najwyżej sto w jednym wywołaniu. Statusy mają w niej nazwy techniczne: backlog, todo, in_progress, in_review, done. Pusty tekst w --sprint odpina tickety od sprintu.

Bez CLI to samo zrobi agent. Wystarczy polecenie w rozmowie, na przykład "przypisz SKL-12, SKL-13 i SKL-14 do aktywnego sprintu i ustaw im status Do zrobienia". Agent użyje jednej operacji zbiorczej zamiast trzech osobnych.

Najczęstsze pytania

Słownik i następny krok

Praca ręczna

praca nad ticketem w Twojej sesji interaktywnej albo bez agenta, a nie w sesji uruchomionej przez dyspozytora

Automatyczne uruchomienie

jednorazowe wznowienie ticketu, który według dyspozytora utknął; w raportach nazywane auto-wznowieniem

Katalog roboczy git

osobny katalog z własnym branchem tego samego repozytorium, tworzony przez git worktree add

Etykieta needs-local

oznaczenie ticketu, którego dyspozytor nie startuje w tle

Odpięcie od sprintu

wyczyszczenie pola sprintu w tickecie; ticket przestaje być widoczny dla dyspozytora

Zatrzymanie całego sprintu i sprzątanie po awarii opisuje wpis Awaryjnie: jak zatrzymać sprint, wyjąć ticket i posprzątać. Znaczenie każdego statusu wyjaśnia wpis Statusy ticketu w Monolynx. Zasady zatwierdzania po poprawkach zbiera wpis Zatwierdzanie i merge: co zawsze robi człowiek.