Doc fonctionnelle : décrit le quoi et le pourquoi (point de vue utilisateur / chef de projet).
Le champ Difficulté d'un item de backlog porte la cotation du poker planning. L'échelle précédente (1 → 21, de « Trop facile » à « Hors norme ») avait été calibrée avant l'usage généralisé de l'assistance IA sur le développement. Depuis, le temps d'écriture du code s'est fortement contracté : les cartes anciennement cotées 21 se réalisent souvent en 8, tandis que les demandes réellement lourdes n'avaient plus de palier disponible au-dessus.
L'échelle a donc été ré-ancrée, et un palier 34 ajouté pour le cas exceptionnel.
Un point vaut environ 2 heures de temps humain, Definition of Done comprise : code, documentation fonctionnelle, documentation technique, tests et recette. Ce n'est pas le temps de génération du code.
| Points | Libellé | Temps visé | Ce que ça décrit |
|---|---|---|---|
| 1 | Trivial | ≤ 2 h | Fast Track : typo, libellé, correctif CSS, une option de liste. Ni doc ni test Dusk. |
| 2 | Très facile | ½ j | Motif déjà appliqué ailleurs, recopié. Aucune décision à prendre. |
| 3 | Facile | ~1 j | On étend un écran existant. Le quoi est clair, le comment existe déjà dans le code. |
| 5 | Moyen | 1,5 j | Fonctionnalité bornée mais neuve : plusieurs fichiers, DoD complète, quelques choix d'architecture. |
| 8 | Sensible | 2-3 j | Touche l'ACL, le multi-tenant, une migration, ou plusieurs modules. Le code est simple, la vérification non. |
| 13 | Difficile | 3,5-4 j | Le besoin n'est pas encore stable : allers-retours métier, plusieurs démonstrations avant convergence. |
| 21 | Très difficile | 5-6 j | Le plafond normal. Terrain nouveau, modèle de données à inventer, dépendance externe. |
| 34 | Hors norme | 8-10 j | Le cas rare. N'entre pas en sprint sans qu'un découpage ait été tenté. |
La fourchette de temps est affichée directement dans les listes de choix (création, édition, filtre), et en infobulle sur le badge de la vue table.
On évalue trois axes séparément et on retient le maximum, jamais la moyenne :
Exemple : rétablir un filtre dtdel manquant sur une requête partagée coûte 1 en exécution, mais 8
en vérification. La carte vaut 8. C'est le principe qui compte le plus dans cette échelle : une
carte au diff minuscule qui touche les droits ou le cloisonnement multi-tenant se côte sur son coût
de validation, pas sur sa taille.
En cas d'hésitation entre deux paliers : le plus haut si le doute est métier, le plus bas si le doute est technique. Un doute technique se lève en une heure d'exploration ; un doute métier, non.
L'ancrage à 2 heures rend la somme des points lisible comme une capacité : une personne tient environ 14 à 16 points par semaine. Une carte à 21 consomme donc à elle seule plus d'une semaine, et une carte à 34 environ deux. Le plafond devient ainsi auto-régulant au moment du vote.
⚠️ Les points ne sont pas comparables de part et d'autre du 25/08/2026. Un sprint à 40 points dans l'ancienne échelle vaut environ 15 points dans la nouvelle. Les instantanés de sprint déjà figés conservent l'ancienne sémantique (ils ne sont pas réécrits), mais tout graphique de vélocité qui traverse cette date est trompeur.
../../.claude/technical-docs/projects/backlog-effort-scale.mdbacklog-filters.md