Comment rédiger une user story Agile : Templates + Exemples

Une user story est la carte d’identité des fonctionnalités à développer. Savoir la rédiger est une des compétences clés de l’application de la méthode agile.

Elle se distingue avec son approche centrée "utilisateurs" ; l’attention n’est plus focalisée sur la conception, mais sur la création d’une valeur réelle pour les clients.

Dans cet article nous verrons grâce à des exemples de user stories concrets, comment réussir à les rédiger.

Vous trouverez aussi des templates à remplir ou pour vous inspirer lors des prochaines préparations de votre backlog.  

Qu’est ce qu’une User Story ?

Une User story, ou récit utilisateur, sont des descriptions d’exigences pour toutes fonctionnalités ou “tâches” nécessaires au fonctionnement du produit ou du service en développement. 

Les user stories sont écrites par le Product Owner de manière concise et ne concerne qu’une seule fonctionnalité à la fois. 

Elles aident à faciliter l'exécution et la compréhension des tâches par les équipes. 

Une fois rédigée, elle va s’ajouter aux autres récits du produit et ensemble ; elles constituent le “product backlog”. 

Le product backlog est en quelque sorte un réservoir de fonctionnalités à développer dans les prochaines itérations. 

Dans cet article, nous nous concentrerons sur les user stories agiles de l’approche Scrum mais pour Kanban, on utilise également ce concept de carte.

Pourquoi rédiger un user story ?

La user story constitue un excellent moyen pour définir votre produit avec clarté.

En voici quelques raisons :

• Elle vous aide à articuler les fonctionnalités de votre produit en utilisant un vocabulaire simple, sans détails techniques
• Elle génère des discussions importantes au sujet du produit
• Elle permet à la fois à l’équipe Scrum et aux parties prenantes externes de mettre en lumière les interrogations ou désaccords potentiels
• Elles aident à clarifier les équipes sur le “quoi” construire, pour “qui”, “pourquoi” et “quand”, mais aussi à la communication du projet en dehors de l’équipe. Souvent les développements des produits digitaux nécessitent un langage technique et complexe, impliquant beaucoup d’acronymes
• Enfin, le récit utilisateur favorise la participation de personnes non techniques au projet

Mais quelles sont alors les règles d’écriture des user stories ?

Les règles d’écriture des User stories sont strictes et doivent être respectées. Elles permettent de définir les avantages que votre produit apporte à ses utilisateurs. 

Voyons comment cela se passe.

Comment bien rédiger une user story Agile ?

Avant de rédiger une user story, il est nécessaire de bien comprendre les besoins des utilisateurs. 

Des profils "Persona" vous aideront à comprendre le problème que le personnage veut voir résolu en utilisant le produit, et ce, à l'aide d'une conception visuelle.

Toutefois, notez qu'avant de créer votre carte de fonctionnalité, notamment si vous utilisez un software de management de projet Agile tel que Jira, il faut que vous définissiez si la carte est une user story, une épic, une tâche ou un bug. 

1. Comprendre ce qui doit être créé : user stories, épics, tâches, bugs

Les épics, user stories et tâches sont différents au niveau de la granularité. 

Ajuster la granularité de son récit permet de trier et ordonner les user stories dans son backlog.

Prenons un exemple simple d’application bancaire.

Si l’épic est l’ « authentification de l’utilisateur », alors les user stories sont:

Et les tâches de l’us « Écran de connexion utilisateur » sont:

Les bugs eux, sont des correctifs à apporter à une user story – développée, testée et rejetée – ou au produit en général suite à son mauvais fonctionnement.

Une fois que vous savez si vous devez créer un bug ou un récit et son niveau de granularité, vous pouvez entamer le processus de rédaction. 

2. Utilisez des Personas pour écrire votre user story

Une excellente technique pour vos user stories consiste à travailler avec des Personas. 

Ce sont des personnages fictifs basés sur une connaissance profonde des utilisateurs de votre produit.

Pour vous familiariser avec vos utilisateurs, le persona représentatif doit être visuel. 

Il se compose généralement :

Son objectif doit représenter le problème que le personnage veut voir résolu en utilisant le produit.

Construire en équipe un Persona peut réellement aider à créer des épics et leurs user stories.

Reprenons l’exemple de l’application bancaire et un de ses Personas: 

Template d’un Personna

Voici le template utilisé vide. N’hésitez pas à le télécharger !

Une fois votre ou vos Personas créés, vous pouvez commencer à écrire vos us. 

Elles doivent être concises et faciles à comprendre.

Il faut éviter les termes confus et ambigus et utiliser le présent.

Concentrez-vous sur ce qui est important pour le Persona concerné par votre US. 

3. Rédiger la user story

Une user story se compose de :

• Un titre
• Le niveau de priorité
• L'estimation de l'user story
• Le format “En tant que”, “je souhaite”, “afin de”
• Les critères d'acceptation que je vous explique plus loin

Ainsi, le format “En tant que”, “je souhaite”, “afin de”, permet de poser les variables les plus importantes de la fonctionnalité : le Qui ? le Quoi ? et le pourquoi ? 

En lisant une user story rédigée avec ce modèle, les développeurs ne peuvent pas faire de mauvaises interprétations. 

Les développements correspondront exactement aux exigences écrites. 

En tant que,

Je souhaite,

Afin que,

Reprenons l’exemple de notre application bancaire et de notre Persona pour rédiger une user story sur le processus du mot de passe oublié (Epic : Authentification utilisateur). 

En tant que utilisateur Untel je souhaite pouvoir réinitialiser mon mot de passe oublié afin d’en recevoir un nouveau et d’accéder à mon espace personnel.

4. Respectez les critères INVEST

INVEST est simplement l’acronyme qui aide à retenir un ensemble de critères pour s’assurer de la qualité d’une user story. 

Si votre récit ne répond pas à l’un de ces critères, l’équipe peut vouloir la reformuler, ou même envisager une réécriture. 

Une bonne user story doit être :

5. Ajouter les critères d’acceptation

Une fois l’objectif de la user story rédigé il faut y ajouter des critères d’acceptation. 

Ces critères vont compléter la User Story en décrivant la manière dans la fonctionnalité sera utilisée, et aussi les cas limites de son utilisation.

Ce sont ces critères qui rendent un récit testable et garantissent qu’elle peut être montrée aux utilisateurs et aux autres parties prenantes lors de la revue sprint.

Je vous conseille d’utiliser trois à cinq critères d’acceptation pour votre user story. 

J’utilise aussi un certain modèle : 

Etant donné que,

Lorsque,

Alors,

Si nous reprenons l’exemple de l’application bancaire et la user story sur le processus du mot de passe oublié : 

Critères d’acceptation :

• Etant donné que je suis sur la page de connexion, lorsque je clique sur “mot de passe oublié” alors je suis redirigé vers la page de réinitialisation du mot de passe
• Etant donné que je suis sur la page “réinitialiser mon mot de passe”, lorsque je rentre et que je valide mon identifiant, alors une vérification de mon identifiant m’informe si oui ou non il existe
• Etant donné que mon e-mail existe lorsque je valide mon identifiant, alors je reçois par sms mon nouveau mot de passe

Modèle de user story

Voici un template pour la rédaction d’une user story Agile.

En conclusion

Les règles d’écriture pour rédiger une user story Agile n’ont plus de secrets pour vous!

Il est très important que le Product Owner discute des récits avec l’équipe et que vous les affiniez ensemble. 

Maintenant que la user story et bien rédigée, il faut alors l’estimer.

N’hésitez pas à me dire en commentaire si les templates vous ont été utiles ! S’ils vous plaisent je veillerai à en insérer dans les prochains articles.