« Il faut zéro dette technique. » Quand un fondateur me dit ça au lancement d'un MVP, je sais qu'on va devoir en parler. Un MVP sans aucune dette est un MVP qui a pris trop de temps. L'objectif d'un MVP est d'apprendre vite si le produit répond à un vrai besoin ; pour ça, on emprunte du temps au futur. La vraie question n'est donc pas « comment éviter la dette » mais « laquelle accepter, laquelle refuser, et comment savoir quand la rembourser ».
Voici la façon dont je la gère sur les produits que je construis, après treize ans à livrer du web, du mobile et du SaaS, de la startup aux grands comptes.
Ma règle : une dette est acceptable si elle est choisie, notée, bornée et réversible. Il suffit qu'un seul de ces quatre critères manque pour qu'elle devienne toxique.
Ce que la dette technique est vraiment
L'expression vient de Ward Cunningham, au début des années 1990. Sa métaphore est financière et elle est juste : livrer un code imparfait, c'est contracter un emprunt. On gagne du temps maintenant, et chaque fois qu'on retravaille ce code, on paie des intérêts sous forme de lenteur. Tant qu'on rembourse, l'emprunt est un levier. Quand on oublie qu'on a emprunté, les intérêts finissent par absorber toute la capacité de l'équipe.
Martin Fowler a proposé une grille utile pour la classer, selon deux axes : la dette est-elle délibérée ou involontaire, prudente ou imprudente ? « On livre ainsi et on reprendra quand on saura » est délibéré et prudent. « On n'a pas le temps de faire des tests » est délibéré et imprudent. « Maintenant qu'on comprend le métier, on aurait découpé autrement » est involontaire et prudent, et c'est inévitable : c'est précisément ce qu'un MVP sert à découvrir.
Dette acceptable, dette toxique : le tableau
| Critère | Dette acceptable | Dette toxique |
|---|---|---|
| Origine | Choix conscient, discuté avec le client | Découverte par hasard, personne ne l'a décidée |
| Traçabilité | Notée dans le registre, avec un déclencheur | Connue d'une seule personne, ou de personne |
| Périmètre | Isolée dans un module, une page, un script | Diffuse, contamine chaque nouvelle fonctionnalité |
| Réversibilité | Se corrige en quelques jours sans migration | Exige une migration de données ou une refonte |
| Zone touchée | Back-office, écrans secondaires, outillage interne | Auth, paiements, modèle de données, sauvegardes, sécurité |
| Exemples | Admin brut, code dupliqué deux fois, pas de cache, tests absents sur une page vitrine | Mots de passe maison, montants en flottants, pas de restauration testée, secrets dans le dépôt |
Les cinq raccourcis que je ne prends jamais
Ma liste est courte, et elle ne bouge pas, quels que soient le budget et la date de lancement. Ce qui réunit ces cinq zones : une erreur y coûte bien plus cher à corriger après coup qu'à éviter dès le départ, et elle peut coûter la confiance des utilisateurs.
- L'authentification. Je ne code pas de gestion de mots de passe ou de sessions maison sur un MVP : j'utilise un service éprouvé. Une faille d'auth ne se corrige pas, elle se déclare. Les options sont comparées dans Clerk ou Supabase Auth.
- Les paiements. Montants en entiers (centimes), webhooks idempotents, état de l'abonnement lu depuis le prestataire de paiement et pas deviné. Une erreur ici, c'est de l'argent encaissé deux fois ou pas du tout, et des clients qui s'en aperçoivent avant vous.
- Le modèle de données. Le code se refactorise, les données s'accumulent. Un identifiant mal pensé, une relation absente, un champ fourre-tout deviennent une migration risquée dès qu'il y a de vrais clients. J'y passe le temps qu'il faut, même sur un MVP de quelques semaines.
- Les sauvegardes. Automatiques, et surtout restaurées au moins une fois pour vérifier qu'elles marchent. Une sauvegarde jamais restaurée n'est qu'une hypothèse.
- La sécurité de base. Secrets hors du dépôt, contrôle d'accès vérifié côté serveur sur chaque route, dépendances à jour, données personnelles traitées comme telles. Ce n'est pas un chantier de fin de projet, c'est une hygiène.
Tout le reste peut attendre : un back-office en tableau brut, une page d'admin laide, une absence de cache, un peu de duplication, une couverture de tests partielle sur du code isolé. J'explique où je place les tests sur un MVP dans tests unitaires pendant un MVP.
Tenir un registre de dette
Une dette non notée est une dette qu'on oubliera jusqu'au jour où elle bloquera une fonctionnalité urgente. Je tiens donc un registre, simple, versionné avec le code ou dans l'outil de tickets du client. Chaque entrée répond aux mêmes questions :
| Champ | Exemple |
|---|---|
id | DETTE-007 |
quoi | Export CSV généré en mémoire, sans pagination |
pourquoi | Démo client vendredi, volumes faibles aujourd'hui |
où | src/exports/csv.ts |
intérêts | Chaque nouvelle colonne demande de toucher trois fichiers |
déclencheur | Premier client avec un export qui dépasse quelques milliers de lignes |
coût estimé | Une journée |
décidé par | Le produit et la tech, en revue de sprint |
Dans le code, le raccourci porte un commentaire qui renvoie au registre, par exemple // DETTE-007 : export non paginé, voir registre. Un simple TODO sans référence ne vaut rien : il ne dit ni pourquoi, ni quand. Le champ le plus important est le déclencheur : il transforme « on verra plus tard » en condition vérifiable. Ce registre fait d'ailleurs partie de ce que je transmets en fin de mission, avec le reste de la documentation de passation.
Les signaux qu'il est temps de rembourser
- Un déclencheur noté dans le registre est atteint.
- Les estimations gonflent sur des fonctionnalités qui paraissent simples, et l'explication commence par « à cause de la façon dont… ».
- Les mêmes zones produisent des régressions sprint après sprint.
- On redoute les mises en production, ou on les regroupe pour en faire moins.
- Une seule personne ose toucher un module.
- Le produit a trouvé ses utilisateurs : ce qui était provisoire est devenu permanent, et les raccourcis pris pour apprendre doivent maintenant tenir la charge.
Rembourser ou pas : la grille de décision
Pour chaque entrée du registre, je croise deux questions : est-ce que ce code va bouger bientôt, et est-ce qu'il touche une zone critique ?
| Situation | Décision |
|---|---|
| Zone critique (auth, paiement, données, sauvegardes, sécurité) | Rembourser maintenant, avant toute nouvelle fonctionnalité |
| Code modifié souvent, intérêts visibles | Rembourser au prochain sprint, dans la part réservée |
| Code modifié souvent, intérêts faibles | Rembourser au passage, quand on touche ce code |
| Code stable, rarement touché | Laisser vivre, revoir le déclencheur |
| Fonctionnalité dont l'avenir est incertain | Ne rien faire : si elle disparaît, la dette disparaît avec |
Cette dernière ligne compte : rembourser la dette d'une fonctionnalité que personne n'utilise est du temps perdu. Mieux vaut parfois supprimer la fonctionnalité.
Budgéter le remboursement : une part de chaque sprint
Le « sprint de nettoyage » trimestriel ne marche pas : il est toujours repoussé par une urgence commerciale. Ce que je fais à la place, c'est réserver une part fixe de chaque sprint au remboursement, convenue dès le cadrage avec le client. Je ne vous donnerai pas de pourcentage magique : c'est une position, pas une statistique. Elle est plus faible juste avant un lancement, plus forte quand le produit a trouvé ses utilisateurs et que les raccourcis commencent à coûter.
Comme le périmètre et le budget sont fixés avant de commencer, cette part est visible dans le chiffrage au lieu d'apparaître comme une surprise. Et elle se voit en démo : chaque semaine, je montre ce qui a été livré, ce qui a été emprunté, et ce qui a été remboursé.
Fondateur non technique : voir la dette arriver
Vous n'avez pas besoin de lire le code pour suivre la dette. Trois réflexes suffisent :
- Demandez le registre. S'il n'existe pas, la dette existe quand même, simplement personne ne la suit.
- Posez la question à chaque démo : « qu'est-ce qu'on a emprunté cette semaine, et quand le rembourse-t-on ? » Une réponse claire est bon signe ; « rien » ne l'est presque jamais.
- Suivez la vitesse dans le temps. Si des demandes comparables prennent de plus en plus longtemps, les intérêts s'accumulent.
Exigez aussi que le code et l'infrastructure soient sur vos propres comptes : c'est la condition pour qu'un autre développeur puisse un jour auditer la dette. J'ai réuni les autres réflexes dans piloter un prestataire tech sans être technique.
Refactoriser ou réécrire
La tentation de tout réécrire arrive presque toujours au moment où la dette devient visible. Je la déconseille dans la grande majorité des cas. Une réécriture gèle les évolutions pendant des mois, et l'ancien code contient des règles métier que personne n'a documentées : on les redécouvre une par une, en production.
Je préfère refactoriser par morceaux, en gardant le produit en ligne : isoler un module, le couvrir de tests, le remplacer, passer au suivant. Une architecture en monolithe modulaire rend ce travail beaucoup plus simple. Je n'envisage une réécriture que dans deux cas : la technologie n'est plus maintenue, ou le modèle de données ne correspond plus du tout au métier. Même alors, je commence par un audit, selon la méthode décrite dans auditer un code avant de reprendre un projet.
Une dette choisie, notée et remboursée régulièrement est un levier. Une dette oubliée devient une hypothèque sur toutes vos fonctionnalités futures.
Faisons le point sur votre dette
Vous lancez un MVP, ou le vôtre ralentit sans que vous sachiez pourquoi ? En un appel de 30 minutes, on peut repérer les zones critiques et décider de ce qui peut attendre. Réservez un créneau, vous repartirez avec une première version de votre registre de dette.
