User story transformată în specificație completă (zeci de rânduri, nimic de discutat)
O poveste cu o descriere de o pagină, cu tabele, endpoint-uri și biblioteci, nu mai lasă loc de discuție cu echipa. Păstrează în descriere nevoia („Ca client, vreau …, ca să …”), mută regulile verificabile în criterii de acceptare, iar detaliile de implementare lasă-le echipei.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O user story este o promisiune de conversație: o descriere scurtă a nevoii, plus criteriile după care știi că e gata. Litera N din INVEST vine de la „Negotiable”: soluția se discută cu echipa, nu vine dictată în descriere.
Greșeala apare când cineva (PO-ul, un analist, lead-ul) vrea să fie sigur că nu scapă nimic și scrie totul dinainte: componente, endpoint-uri, indexuri, biblioteci. Povestea pare completă, dar are trei probleme. Nevoia omului se pierde printre detalii tehnice. Echipa nu mai propune soluții mai simple, pentru că „așa scrie”. Iar textul devine greu de verificat: ce e cerință și ce e doar o idee de implementare?
Reparația: descrierea rămâne scurtă, în format de user story. Regulile pe care le poate verifica oricine (ce vede clientul, în ce ordine, câte pe pagină) devin criterii de acceptare. Deciziile tehnice se iau de echipă, la rafinare sau în sprint.
De ce apare: cauzele frecvente
1Descrierea dictează implementarea
Pagina se face în React cu componenta TabelComenzi.
Endpoint GET /api/orders?page=1&size=20.
Indexul pe orders.user_id trebuie creat.Ca client, vreau să-mi văd comenzile anterioare,
ca să găsesc rapid ce am cumpărat.
Criterii: cele mai noi primele; 20 pe pagină; anulatele marcate.Descrierea spune nevoia, criteriile spun ce se verifică. Cum se face (componente, indexuri) decide echipa.
2Criteriile sunt îngropate în text
… Coloanele: număr, dată, total, status. Paginare de 20.
Comenzile anulate apar cu gri. …- Văd numărul, data, totalul și statusul fiecărei comenzi
- Văd 20 de comenzi pe pagină
- Comenzile anulate sunt marcate vizibilCa listă separată, fiecare regulă poate fi bifată la testare. În paragraf, se pierd ușor.
Corectează greșeala, direct în pagină
În Backlog, povestea S4 „Istoricul comenzilor” are drept descriere o specificație lungă, plină de detalii tehnice.
Scrie pentru S4 o descriere scurtă (cel mult 200 de caractere), în formatul „Ca client, vreau …, ca să …”, și adaugă cel puțin 3 criterii de acceptare din regulile vizibile pentru client (ordinea, numărul pe pagină, comenzile anulate).
Indiciu
Ce vede clientul devine criteriu; React, endpoint-urile și indexurile nu intră în poveste.
Reparația
Click pe S4. Descrierea:
Ca client, vreau să-mi văd comenzile anterioare, ca să găsesc rapid ce am cumpărat și când.Criterii de acceptare:
Comenzile apar de la cea mai nouă la cea mai veche
Văd 20 de comenzi pe pagină
Pentru fiecare comandă văd numărul, data, totalul și statusul
Comenzile anulate sunt marcate vizibilDe ce merge
Povestea spune acum nevoia clientului într-o frază, iar regulile care contează pentru el sunt criterii separate, ușor de verificat la testare. Componentele React, endpoint-ul și indexul din baza de date au dispărut din poveste: sunt decizii ale echipei, care le poate discuta la rafinare și le poate schimba fără să rescrie cerința.
Alte forme ale mesajului
User story prea detaliatăSpecificație lipită în descrierea poveștiiUser story care nu e negociabilă (INVEST)
Cum o eviți pe viitor
- Descrierea poveștii: o frază în formatul „Ca …, vreau …, ca să …”, cel mult câteva rânduri de context.
- Regulile verificabile merg în criterii de acceptare, câte una pe rând.
- Deciziile tehnice se discută cu echipa; dacă sunt importante, notați-le în task-uri sau într-un document tehnic, nu în poveste.
- La rafinare, întrebați: ce e cerință a clientului și ce e doar o idee de implementare?
Întrebări frecvente
Nu e bine să fie totul scris, ca să nu uităm nimic?
E bine să nu uitați regulile importante, și de aceea ele devin criterii de acceptare. Detaliile de implementare însă se schimbă des, iar dacă le scrii dinainte, echipa nu mai caută soluția cea mai simplă.
Unde pun schițele de interfață sau deciziile de arhitectură?
Ca atașament sau link la poveste, ori în task-urile din sprint. Povestea rămâne scurtă și ușor de citit.
Greșeli înrudite
Criterii de acceptare care descriu implementarea („se folosește Redis”) Criteriile spun cum se construiește („se folosește Redis pentru cache”, „tabela are index pe email”), nu ce trebuie să se întâmple pentru utilizator. Rescrie-le ca rezultate observabile („pagina se încarcă în cel mult 2 secunde”) și lasă alegerea tehnică developerilor. User story care impune soluția de interfață („un buton roșu în dreapta sus”) Povestea descrie ecranul în detaliu (buton, culoare, poziție), dar nu nevoia omului, așa că echipa implementează un desen, nu rezolvă o problemă. Scrie în poveste ce vrea utilizatorul și de ce, iar detaliile de design mută-le într-o schiță atașată sau lasă-le discuției cu designerul. Poveste cu prea multe criterii de acceptare (de fapt sunt mai multe povești) O poveste cu 10–15 criterii, fiecare despre altă funcționalitate, e de fapt un pachet de povești. Grupează criteriile pe comportamente și sparge povestea astfel încât fiecare parte să aibă puține criterii (de regulă 3–5) și să poată fi livrată singură. Învață Scrum și Agile de la zero, cu exerciții la fiecare lecție
Curs Scrum și Agile: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
