...
Greșeală frecventă Scrum și Agile · User stories

User story transformată în specificație completă (zeci de rânduri, nimic de discutat)

Pe scurt

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

Greșit
Pagina se face în React cu componenta TabelComenzi.
Endpoint GET /api/orders?page=1&size=20.
Indexul pe orders.user_id trebuie creat.
Corect
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

Greșit
… Coloanele: număr, dată, total, status. Paginare de 20.
Comenzile anulate apar cu gri. …
Corect
- Văd numărul, data, totalul și statusul fiecărei comenzi
- Văd 20 de comenzi pe pagină
- Comenzile anulate sunt marcate vizibil

Ca listă separată, fiecare regulă poate fi bifată la testare. În paragraf, se pierd ușor.

Repară tu

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.

Alte forme ale mesajului

  • User story prea detaliată
  • Specificație lipită în descrierea poveștii
  • User 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

← Toate greșelile Scrum și Agile

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.