Voici une liste de quelques absurdités :

  • Au lieu de me brosser les cheveux tous les jours, je vais planifier ça pour le mois prochain.
  • Je n'ai pas le temps de me brosser les dents aujourd'hui, ni demain, ni la semaine prochaine… Alors j'irai plutôt chez le dentiste le mois prochain.
  • Les vaccins des enfants, on les planifiera tous pour… dans 3 ans… on n'a pas le temps cette année.
  • Je suis tombé malade, le médecin m'a prescrit des antibiotiques… mais je prévois de les prendre dans 2 semaines.
  • Planifieriez-vous de vous couper les ongles tous les mois plutôt que toutes les semaines ?
  • Pourriez-vous prévoir une douche « quand c'est possible » plutôt que quand il le faut ?

La dette technique n'existe pas. Le choix d'accepter la médiocrité existe.

Il y a toujours un trade-off adapté, un trade-off propre qui vous permet d'aller plus vite. Ce ne sera pas une dette, juste une solution adaptée à votre juste besoin.

Pour cela, un architecte doit comprendre et maîtriser un large éventail d'options possibles.

Pourquoi les équipes planifient-elles la dette ?

La liste fait sourire parce qu'elle est familière. Chaque ligne traite un coût comme une chose qu'on peut reporter sans conséquence. Reporter le brossage des dents semble ne rien coûter, parce que les dégâts restent invisibles un moment. La facture arrive plus tard, et elle dépasse l'économie.

Les raccourcis logiciels se comportent de la même façon. Ward Cunningham a introduit la métaphore de la dette en 1992, dans un retour d'expérience sur le système de portefeuille WyCash. Livrer du code qui n'est pas tout à fait juste, c'est comme emprunter de l'argent. Chaque changement suivant paie des intérêts sous forme de travail en plus, jusqu'à ce que la dette soit remboursée, en général en réécrivant la partie bâclée.

Martin Fowler sépare la dette délibérée, prise avec un plan, de la dette qui vient du fait de ne pas savoir faire mieux. La première peut être une bonne décision. La seconde, c'est ce qu'un planning cache. Un plan qui dit « on nettoiera le mois prochain » nomme rarement le travail, le responsable ou le déclencheur, donc la dette continue de grossir pendant que le plan reste dans le calendrier.

La dette technique, ça se planifie ?

La métaphore casse à un endroit, et c'est là que se fait l'erreur de planification. La dette n'est pas un objet dans le code qu'on peut déplacer au mois prochain. C'est une décision qui a un coût, et ce coût grandit avec chaque changement qui dépend du raccourci.

Chaque nouvelle feature construite sur un raccourci doit le contourner. Le développeur ajoute un flag, un cas particulier ou la copie d'une méthode. L'estimation suivante s'allonge, et le nettoyage devient plus dur, parce que plus de code dépend maintenant de l'ancien design.

Planifier le remboursement pour le mois prochain, tout en ajoutant de nouvelles features par-dessus, ne réduit pas la dette. Cela ne fait qu'augmenter le capital qu'il faudra rembourser.

Qu'est-ce qu'un trade-off adapté ?

Un trade-off adapté, ce n'est pas la perfection. C'est le design le plus simple qui répond aux besoins d'aujourd'hui et qui ne bloque pas le prochain changement. Un design propre vous permet d'aller plus vite parce que le prochain changement ne coûte pas cher.

En logiciel, simple est synonyme de sophistiqué. Un design ne peut paraître simple qu'après que quelqu'un a compris le problème en profondeur et retiré tout ce qui n'a rien à y faire. Y arriver demande de l'expertise, et la volonté de refactorer au fil du travail.

Le refactoring est la pratique qui rend le trade-off bon marché. Martin Fowler le définit ainsi : changer la structure interne du code sans changer son comportement observable, par petits pas, chacun vérifié par des tests. Le nettoyage n'attend pas un projet à part. Il se fait dans la story qui révèle le désordre.

Gardez les tests au vert pendant ce temps. Les tests permettent de refactorer sans peur. Sans eux, chaque nettoyage est un pari, et les équipes planifient le pari pour plus tard parce qu'il semble trop risqué de le faire maintenant.

Comment arrêter de planifier la dette ?

  1. Nommez le raccourci dans le ticket, avec des mots simples.
  2. Chiffrez-le : quel travail en plus chaque changement futur paie-t-il à cause de ce raccourci ?
  3. Décidez : le rembourser maintenant, ou l'accepter avec un déclencheur de remboursement nommé.
  4. Refactorez dans la même story, par petits pas, avec les tests au vert.
  5. Mettez le nettoyage dans la definition of done, pas dans le backlog du mois prochain.
  6. Passez la liste des dettes en revue à chaque rétrospective, et fermez les éléments qui coûtent le plus.

L'étape 2 est celle où la plupart des plans échouent. Un raccourci sans prix n'est qu'une impression, et une impression ne gagne pas une réunion de priorisation. Comptez le travail en plus en heures, ou en nombre de fichiers touchés par chaque changement. Un chiffre suffit pour décider.

L'étape 5 est celle qui change les comportements. Un nettoyage qui vit dans un backlog à part est en concurrence avec chaque nouvelle feature, et il perd à chaque fois. Un nettoyage dans la story est payé par ceux qui en profitent.

Quand une dette planifiée est-elle acceptable ?

Elle est acceptable quand l'équipe la prend exprès. Une expérimentation limitée dans le temps, un prototype qui sera jeté, ou une échéance fixée par le métier peuvent justifier un raccourci. Fowler appelle le premier cas une dette prudente et délibérée.

La condition est stricte. La dette doit être écrite, avoir un responsable et avoir un déclencheur, par exemple « avant la mise en production du deuxième client » ou « quand l'équipe ajoute le prochain moyen de paiement ». Quand le déclencheur se produit, la dette est remboursée. Sans ces trois choses, ce n'est pas une décision. C'est un planning d'évitement.

The Pragmatic Programmer décrit un problème proche avec les vitres cassées. Un seul défaut négligé dit à la personne suivante que les défauts sont acceptables, et le désordre grandit à partir de là. La solution : réparer la vitre tant qu'il n'y en a qu'une.

Le rôle de l'architecte se joue ici aussi. Un architecte doit connaître assez bien les options pour proposer un trade-off propre, pas une réponse unique. Dix ans d'expérience, ce n'est pas une année répétée dix fois. L'architecte est celui qui sait quel raccourci se rembourse à bas prix et lequel va accumuler les intérêts.

💡 La dette n'est pas une date dans le backlog. C'est un choix, et il fait payer des intérêts sur chaque changement jusqu'à ce que quelqu'un le rembourse.

Ressources et bibliographie

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