# Karta jednego zadania z agentem

Użyj istniejącego zadania i planu. Ten plik jest krótkim załącznikiem do rozmowy, a nie nowym rejestrem pracy.

## Co ma być gotowe

- Zadanie lub istniejący plan: **[znane: … / do ustalenia]**
- Potrzeba użytkownika lub problem: **[źródło / do ustalenia]**
- Ustalenia z ekspertem dziedzinowym i wiedza do wykorzystania: **[źródła / otwarte pytania]**
- Zmiana w jednym zdaniu: **[do ustalenia]**
- Osoba prowadząca i jej znajomość obszaru: **[do ustalenia]**
- Rodzaj potrzeby i odbiorca: **[biznesowa / techniczna; rola odbierająca]**
- Kryteria odbioru: **[do ustalenia]**
- Zakres i wyłączenia: **[do ustalenia]**
- Źródła wiedzy oraz ograniczenia dostępu: **[do ustalenia]**

## Gdy pracujecie równolegle

Dzielcie całe funkcje między AI Engineers. Przed uruchomieniem agentów uzupełnijcie z ich rozpoznania:

| Ustalenie | Zapis przy tym zadaniu |
| --- | --- |
| Funkcja i prowadzący | [czynność użytkownika; ekran, logika i dane w zakresie] |
| Zadanie drugiej osoby | [link i zakres; dlaczego można pracować równolegle] |
| Wspólne elementy | [pliki, komponenty, dane, reguły lub format komunikacji; brak kolizji też trzeba sprawdzić] |
| Kto zmienia wspólny fragment | [właściciel, kolejność i wersja do uwzględnienia przez drugą osobę] |
| Oddzielne miejsce pracy | [gałąź i katalog; bez edytowania plików drugiego agenta] |
| Połączenie i próba | [kto łączy, jaki scenariusz sprawdzi po połączeniu, kto potwierdzi wynik] |

Nowa kolizja w trakcie pracy oznacza zatrzymanie zmiany wspólnego fragmentu i uzgodnienie zakresu. Osobne gałęzie nie rozwiązują sprzecznych zmian w danych lub działaniu aplikacji.

## Przebieg

| Etap | Uzgodnienie | Dowód wyniku |
| --- | --- | --- |
| Plan | Odnośnik do istniejącego planu; decyzje wymagające właściciela | [do uzupełnienia] |
| Wykonanie | Mały, wskazany zakres; odpowiedzialny wykonawca | [do uzupełnienia] |
| Demo | Co człowiek obejrzał, zebrane uwagi, poprawki teraz lub po pokazie, wynik ponownego sprawdzenia | [do uzupełnienia] |
| Testy | Sprawdzenia dobrane do ryzyka i ich wyniki | [do uzupełnienia] |
| Przegląd | Inny, mocniejszy model pracuje w świeżym kontekście; najpierw bez edycji | [do uzupełnienia] |
| Dokumentacja | Strony Confluence, źródła, wersja, osoba sprawdzająca; braki w istniejącym planie | [do uzupełnienia] |
| Przekazanie | Wersja, wykonany zakres, wyniki, ograniczenia i następny krok | [do uzupełnienia] |

## Modernizacja — gdy wymieniacie część systemu

Wpisz te cztery rzeczy, zanim agent zaproponuje zmianę. Dzięki temu nowa wersja nie udaje, że stare zachowanie nie istniało.

| Co sprawdzamy | Do uzupełnienia |
| --- | --- |
| Zachowanie dzisiaj | [co robi wersja obecna; skąd to wiemy] |
| Zachowanie po zmianie | [co pozostaje takie samo; uzgodnione różnice i przypadki graniczne] |
| Dane i zgodność | [czy istniejące dane, API lub integracja wymagają obsługi starego formatu] |
| Wycofanie | [jak wrócić do poprzedniej wersji; wpływ na dane; kto jest uprawniony] |
| Warunek przełączenia | [kto sprawdza zgodność, jakie wyniki pozwalają przełączyć fragment, co blokuje przełączenie] |

### Porównanie starej i nowej wersji

Weźcie tę samą czynność użytkownika i te same dane dopuszczone do testów. Agent uzupełnia wiersze rzeczywistymi wynikami, po wykonaniu prób.

| Przypadek do wybrania z waszego projektu | Obecna wersja | Nowa wersja | Decyzja o różnicy |
| --- | --- | --- | --- |
| Zwykła czynność użytkownika | [wynik i dowód] | [wynik i dowód] | [bez zmiany / do wyjaśnienia] |
| Znany wyjątek lub wcześniejszy błąd | [wynik i dowód] | [wynik i dowód] | [decyzja oraz kto ją potwierdził] |
| Brak lub błędne dane | [wynik i dowód] | [wynik i dowód] | [decyzja oraz kto ją potwierdził] |
| Dane już zapisane | [liczba, identyfikatory, wybrane rekordy] | [porównanie] | [czy zachowano dostęp i znaczenie danych] |

**Przed przełączeniem:** osoba sprawdzająca porównuje wyniki; niewyjaśniona różnica blokuje przełączenie. Jeśli zmienia się zapis danych, plan musi uwzględnić dane dodane już po przełączeniu i możliwość odczytania ich po powrocie do starszej wersji. Próbę cofnięcia wykonujemy najpierw na dopuszczonej kopii danych.

## Jak przygotować demo waszego zadania

Wskażcie ekran lub punkt startu, dane do próby i czynność użytkownika. Zapiszcie oczekiwany wynik jeszcze przed pokazem. Przejdźcie zwykły przypadek, brak danych i znany wyjątek. Jeśli zmiana dotyczy dostępu, sprawdźcie konta z odpowiednimi rolami. Po pokazie dopiszcie rzeczywisty wynik i uwagi, zamiast z góry oznaczać kryteria jako spełnione.

Małe zadanie również wymaga obejrzenia wyniku przez człowieka. W trakcie pokazu możecie zatrzymać agenta, zapisać uwagę albo zlecić poprawkę od razu. Listę trzymajcie w istniejącym planie lub zadaniu. Po większych poprawkach powtórzcie demo zmienionego scenariusza; przy małych sprawdźcie poprawione miejsce. Ryzykowne zmiany nadal wymagają właściwych testów.

| Uwaga z demo | Uzgodniona poprawka | Wynik sprawdzenia | Odbiór człowieka |
| --- | --- | --- | --- |
| [miejsce i problem] | [teraz / po pokazie; zakres] | [wersja, wynik, dowód] | [oczekuje / obejrzane i przyjęte / dalsze uwagi] |

## Osobna decyzja o publikacji

- Czy wynik został odebrany technicznie? **[tak / nie / nieznane]**
- Czy istnieje wyraźna zgoda na wydanie dla wskazanego środowiska? **[tak / nie / do ustalenia]**
- Kto zatwierdził wydanie i kto jest uprawniony je wykonać? **[do ustalenia]**

Odbiór zadania nie jest automatyczną zgodą na wydanie, wysłanie komunikatu ani zmianę środowiska.

## Prompt do uzupełnienia karty

```text
Przeczytaj tę kartę i dozwolone źródła: [linki]. Uzupełnij wyłącznie pola,
które potwierdzają źródła. Przy każdym fakcie dodaj link lub nazwę źródła i wersję.
Oddziel brak, sprzeczność i propozycję od potwierdzonej informacji.
Jeśli pracujemy równolegle, wskaż nakładające się zakresy i wspólne zależności.
Nie wymyślaj ich właściciela ani nie nadpisuj cudzej pracy.
Jeśli to istniejący system, wypełnij tabelę starego i nowego zachowania, danych
oraz wycofania. Najpierw pokaż tekst do uzgodnienia.
Nie wykonuj zmian w plikach, Jira, Confluence, GitHubie, środowisku ani komunikacji.
```