Jak pisać zadania — szablon

Każde pole w tym szablonie to pytanie, które i tak muszę zadać, zanim zacznę robić zadanie. Jeśli odpowiedź jest w zadaniu od razu — robię od razu. Jeśli jej nie ma — czekam na Ciebie albo zgaduję, a czasem zgadnę nie tak, jak chciałeś.

Szablon — skopiuj i wypełnij

TYTUŁ: [czasownik + co, np. „Dodaj filtr tagów na stronie głównej"]
PROJEKT: [nazwa projektu / środowiska — jeśli prowadzimy więcej niż jeden]

CEL — po co to robimy?
[1–2 zdania: jaki problem to rozwiązuje albo co ma dać biznesowo]

OPIS — co dokładnie ma powstać?
- Gdzie w aplikacji: [adres strony / nazwa podstrony / moduł]
- Dla kogo: [użytkownik zalogowany / niezalogowany / obaj / panel administracyjny]
- Jak ma działać: [krok po kroku: co widzi i co klika użytkownik]

KRYTERIA AKCEPTACJI — zadanie jest gotowe, gdy:
1. [...]
2. [...]
3. [...]

MATERIAŁY:
[linki, screeny, teksty, przykłady z innych stron — albo „brak"]

DECYZJE OTWARTE:
[pytania, na które nie znasz odpowiedzi — napisz „zdecyduj sam" albo podaj swoją odpowiedź]

Co wpisać w każde pole

TYTUŁ. Jedno zdanie, od czasownika. Po samym tytule ma być jasne, co się zmieni.

PROJEKT. Jeśli pracujemy nad więcej niż jednym projektem albo projekt ma kilka wersji czy środowisk — zawsze napisz, którego dotyczy zadanie. Jeśli projekt jest jeden, pomiń to pole.

CEL. Po co to robimy. Gdy znam cel, mogę zaproponować prostsze rozwiązanie tego samego problemu.

OPIS. Co dokładnie ma powstać i gdzie. Pisz z perspektywy osoby, która to zobaczy i kliknie.

KRYTERIA AKCEPTACJI. Lista rzeczy do odhaczenia. To po niej sprawdzisz, czy zadanie jest zrobione — i po niej ja sprawdzam przed oddaniem.

MATERIAŁY. Wszystko, co masz: screeny, linki, teksty, przykład z konkurencji. „Brak” też jest odpowiedzią.

DECYZJE OTWARTE. Rzeczy, których nie wiesz. Napisz „zdecyduj sam” — wtedy nie czekam na Ciebie.

Pięć zasad

1. Liczby zamiast przymiotników. „Co 3 dni”, „5 punktów”, „max 12 zdjęć” — a nie „często”, „tanio”, „kilka”. Przymiotnik każdy rozumie inaczej; liczbę wszyscy tak samo.
2. Teksty widoczne dla użytkownika podaj dosłownie. Napisy na przyciskach, komunikaty, nazwy sekcji — słowo w słowo. Albo napisz wprost: „wymyśl sam”.
3. Kryterium akceptacji musi dać się sprawdzić odpowiedzią TAK / NIE. „Ma być ładnie” — nie da się. „Na telefonie karty układają się w jedną kolumnę” — da się.
4. Jedno zadanie = jedna rzecz. Jeśli piszesz „a przy okazji…” — to jest drugie zadanie. Wyślij je osobno, każde z własnymi kryteriami.
5. Nie znasz odpowiedzi? Napisz „zdecyduj sam”. To odblokowuje pracę. Najgorsze jest pole zostawione puste — nie wiadomo, czy to przeoczenie, czy wolna ręka.

Przykład dobrze napisanego zadania

Tytuł Dodaj odznakę „NOWE” na kartach świeżo dodanych produktów

Projekt Sklep — wersja polska i angielska.

Cel — po co to robimy? Nowe produkty giną między starymi — użytkownik nie widzi, że od jego ostatniej wizyty coś doszło. Odznaka ma podbić klikalność nowości.

Opis — co dokładnie ma powstać?

• Gdzie: strona główna (lista produktów) + strony kategorii.
• Dla kogo: użytkownik — zalogowany i niezalogowany.
• Jak ma działać: karta produktu dodanego w ciągu ostatnich 14 dni ma w rogu zdjęcia odznakę „NOWE”. Po 14 dniach odznaka znika sama, bez niczyjego klikania.

Kryteria akceptacji — gotowe, gdy

• Produkt dodany ≤ 14 dni temu ma odznakę na karcie — na stronie głównej i na stronie kategorii.
• Po 14 dniach odznaka znika automatycznie.
• Na telefonie odznaka nie zasłania zdjęcia produktu.
• Działa w obu wersjach językowych, z przetłumaczonym napisem.

Materiały Brak — kolor i kształt odznaki dobierz do wyglądu strony.

Decyzje otwarte Nie wiem, czy 14 dni to dobry próg. Zdecyduj sam i napisz w podsumowaniu, ile ustawiłeś.

Zasada minimum: jeśli nie masz czasu wypełnić wszystkiego, wypełnij chociaż TYTUŁ, CEL i KRYTERIA AKCEPTACJI. Reszta pól przyspiesza pracę — te trzy ją w ogóle umożliwiają.

P.S. Ten szablon napisałem dla ludzi, którzy zlecają mi pracę. Potem okazało się, że zadanie napisane według niego jest też idealnym wejściem dla agentów AI piszących kod — kryteria akceptacji sprawdzalne odpowiedzią tak/nie to gotowa checklista dla automatycznego recenzenta, a „decyzje otwarte” to pytania, na których agent by się zawiesił. Dobre zadanie dla człowieka i dobre zadanie dla maszyny to to samo zadanie. Więcej o tym w Sędzia, który podejmuje decyzje.