Cela peut prendre quelques minutes ou quelques jours, selon la capacité de l'équipe à communiquer et sa méthodologie. La différence vient rarement du code.

Voici le processus que je suis. Coder en est la dernière étape : l'étape 10 sur 10. L'essentiel du travail se fait avant que quelqu'un ouvre un éditeur.

Comment démarre une feature dans mon processus ?

Je lis d'abord la demande, la description du problème. Puis je réfléchis seul. Je ne réponds pas encore.

Ensuite, je reformule le problème avec mes mots. Je pose des questions à ceux qui peuvent y répondre, et je challenge les idées avec les autres membres de l'équipe. Puis nous réfléchissons ensemble, en équipe.

Après cela, je prends du recul et je regarde la code base. Le code me dit ce que le système fait déjà, et ce qu'il a le droit de faire. Si les règles métier ne sont toujours pas claires, je demande à un expert du domaine de réfléchir avec moi.

Puis nous écrivons des exemples. Je réfléchis encore, cette fois en termes de patterns tactiques et de frontières possibles. Enfin, nous découpons le travail en étapes livrables : de petits tickets, livrables, qui rendent un utilisateur heureux.

Alors seulement je code, ou je laisse quelqu'un d'autre le faire.

Pourquoi réfléchir avant de coder fait-il gagner du temps ?

L'ingénierie consiste d'abord à résoudre des problèmes. L'implémentation vient ensuite. Cet ordre, c'est toute l'idée derrière les dix étapes.

Une feature est un pari sur un problème. Si le problème est mal lu, chaque ligne de code repose sur une hypothèse fausse. L'erreur ne disparaît pas. Elle passe en revue, puis en test, puis en production, là où elle coûte le plus cher.

Le code est l'endroit le plus cher pour découvrir un malentendu. C'est là qu'il y a le plus de choses accrochées : des tests, des revues, des déploiements et des utilisateurs. Une conversation coûte bien moins cher qu'une branche à jeter.

C'est dans les exemples que les malentendus apparaissent. Une exigence abstraite paraît claire à chacun, mais chacun la lit à sa façon. Un exemple concret force la question : que se passe-t-il quand le panier est vide ? Gojko Adzic appelle cette pratique la specification by example. Les exemples deviennent la spécification, et toute l'équipe peut les vérifier.

La demande que vous recevez est l'énoncé d'un problème, pas un manuel de solution. Traitez-la comme telle. Demandez quel problème elle résout avant de demander comment la construire.

Réfléchir seul ne suffit pas, et se contenter de discuter ne suffit pas non plus. La première passe est la vôtre, la seconde est celle de l'équipe. Chacune attrape ce que l'autre laisse passer. Celui qui réfléchit seul peut construire une réponse propre à la mauvaise question. Un groupe où personne n'a fait sa première passe débat sans rien de concret.

Quelle est la règle derrière les dix étapes ?

La règle est courte : think twice, code once. Chaque boucle de réflexion se passe dans une conversation. Chaque boucle de reprise se passe dans une branche, une revue et un nouveau passage des tests. La boucle la moins chère doit passer en premier.

La deuxième règle, c'est le découpage. Un ticket qui prend des jours cache son risque jusqu'au troisième jour. Dans User Story Mapping, Jeff Patton dispose le travail le long du parcours de l'utilisateur, puis coupe de fines tranches qui apportent chacune de la valeur. Les petites tranches rendent le risque visible tôt, parce qu'un faux pas échoue en quelques heures, pas en quelques semaines.

Le découpage garde aussi l'équipe honnête sur ce qui est terminé. Une tranche marche pour un utilisateur, ou elle ne marche pas. Pas de feature à moitié finie cachée dans une branche. Comment je découpe une feature, pas à pas : le découpage vertical.

Réfléchissez, puis réfléchissez encore. Dans ma séquence, la deuxième passe vient après le retour des premières réponses, quand le tableau a changé. Chaque passe coûte peu. Souvent, la deuxième passe retire une partie de la feature dont personne n'avait besoin, et c'est le code le moins cher que vous n'écrirez jamais.

Comment est-ce que je déroule ces étapes sur un vrai ticket ?

Voici la séquence sous forme de checklist. Chaque étape se termine par un résultat visible.

  1. Lisez la demande deux fois. Notez le besoin de l'utilisateur, pas la solution proposée.
  2. Écrivez vos premières réflexions avant de répondre.
  3. Posez les questions à ceux qui détiennent les réponses.
  4. Challengez les idées, en commençant par les vôtres.
  5. Réfléchissez ensemble, en équipe, et mettez-vous d'accord sur le problème.
  6. Ouvrez la code base et regardez ce qui existe déjà.
  7. Demandez à un expert du domaine quand une règle métier n'est pas claire.
  8. Écrivez des exemples concrets, et faites-les confirmer.
  9. Définissez les frontières, puis découpez le travail en petits tickets.
  10. Codez, ou confiez le code à la personne la mieux placée pour le faire.

L'étape 8 est celle que les équipes sautent le plus souvent. Si les exemples ne sont pas écrits, c'est le code qui répondra aux questions à votre place. Les réponses ne vous plairont pas.

L'étape 4 est celle où partent les jours. Une équipe qui n'a pas l'habitude de se challenger y passera plus de temps, et le calendrier le montre. Les étapes restent les mêmes. C'est la capacité à communiquer qui décide de la durée.

Quand les étapes ne s'appliquent-elles pas ?

Dix étapes pour une faute de frappe, c'est du gaspillage. Mary Poppendieck et Tom Poppendieck rangent les fonctionnalités en trop et le travail à moitié fait parmi les gaspillages qui ralentissent les équipes logicielles. Un processus qui prend plus de temps que le changement lui-même est ce genre de gaspillage.

Utilisez la séquence complète quand le travail touche une règle métier, de l'argent, ou un flux dont beaucoup de gens dépendent. Pour un changement de texte, deux lignes dans une conversation suffisent.

Les petites équipes compressent souvent les étapes 2 à 4 en une seule discussion. C'est très bien. L'ordre compte plus que la longueur de chaque étape. Gardez les questions, gardez les exemples, et laissez tomber la cérémonie.

💡 À retenir : think twice, code once ! Coder, c'est l'étape 10. Réussissez les neuf premières, et l'étape 10 devient la partie courte.

Ressources et bibliographie

Publié d'abord sur LinkedIn : le post d'origine