---
title: "Onboarding développeur lent : les causes | QMates"
source: https://qmates.tech/fr/services/transformation/coaching-technique-xp-tdd/integration-developpeurs-lente
description: "Un onboarding lent coûte des mois au nouvel arrivant et du temps aux seniors : code illisible, tests absents, savoir détenu par quelques personnes."
updated: 2026-11-21
---

Onboarding développeur lent

# Un nouveau développeur met des mois à devenir autonome

Le nouvel arrivant interroge les seniors, parce que le code ne s’explique pas tout seul et que les tests qui serviraient de filet manquent. Les seniors répondent, le temps de rendre le code plus lisible n’arrive jamais, et le suivant devra en demander davantage encore. L’onboarding reste lent pour trois raisons qui s’additionnent : le code, les pratiques de l’équipe et le savoir détenu par quelques personnes.

## Vous vous reconnaissez ?

-   Le nouvel arrivant passe ses premières semaines à lire du code sans savoir par où commencer.
-   Pour comprendre une partie du système, il faut toujours s’adresser à la même personne.
-   Les premières modifications des nouveaux cassent quelque chose, parce que les règles à respecter n’ont jamais été écrites.
-   La documentation existe, mais elle décrit un système qui a changé depuis.
-   Chaque nouvelle arrivée prend du temps aux seniors qui l’accompagnent, et la livraison s’en ressent.

## Où le nouvel arrivant se bloque-t-il ?

Un nouveau développeur est autonome quand il peut modifier le code et savoir aussitôt s’il a cassé quelque chose. Le code qui ne s’explique pas et les tests absents lui retirent cette assurance et le renvoient vers les quelques personnes qui savent, et c’est là que l’onboarding s’enraye.

1.  ### Le code ne s’explique pas tout seul

    Modules couplés, noms qui ne viennent pas du domaine, conventions qui n’existent que dans la tête des personnes présentes depuis le début, et pour savoir par où commencer il faut un guide. La documentation tente de combler le vide et devient vite obsolète, alors qu’un code aux frontières claires, nommé avec les mots du produit, se laisse lire même par quelqu’un qui le découvre.

    Alimente

    -   

    [

    Nous le traitons avec

    Refactoring du code legacy](https://qmates.tech/fr/services/transformation/refactoring-code-legacy)

2.  ### Il manque les tests qui font office de filet

    Sans tests automatisés, le nouvel arrivant ne sait pas si sa modification a cassé quelque chose, et il avance prudemment ou demande confirmation à chaque pas. Bien écrits, les tests décrivent aussi le comportement attendu du système, et ils forment la description la plus à jour qu’une équipe puisse avoir.

    Alimente

    -   

    [

    Nous le traitons avec

    Coaching technique XP et TDD](https://qmates.tech/fr/services/transformation/coaching-technique-xp-tdd)

3.  ### Le savoir tient dans quelques têtes

    Si une partie du système n’est connue que d’une seule personne, l’onboarding dépend du temps qu’elle parvient à dégager, et chaque nouvelle arrivée le lui prend sur son propre travail.

    [

    Nous le traitons avec

    Équipes intégrées](https://qmates.tech/fr/services/transformation/equipes-integrees)

4.  ### On apprend seul, à force de questions

    L’accompagnement se réduit souvent à quelques questions quand le nouveau est bloqué. Travailler en binôme sur de vraies tâches, en alternant au clavier, transmet ce qu’aucun document ne contient, à savoir la façon de raisonner sur ce code et les raisons de certains choix.

    Alimente

    -   

    [

    Nous le traitons avec

    Coaching technique XP et TDD](https://qmates.tech/fr/services/transformation/coaching-technique-xp-tdd)

- [Le service qui s’en charge](https://qmates.tech/fr/services/transformation/coaching-technique-xp-tdd)
- [Vous ne savez pas quelle cause pèse le plus ?](https://qmates.tech/fr/services/transformation/diagnostic-delivery-logiciel)

## Ce qui change quand le nouvel arrivant devient vite autonome

Le nouvel arrivant travaille sur de vraies tâches dès le début, en binôme avec quelqu’un qui connaît le code, et les tests lui disent tout de suite si une modification a cassé quelque chose. Les questions diminuent, parce que beaucoup de réponses se trouvent déjà dans le code et dans les tests et ne retombent plus sur les seniors.

Quand un poste s’ouvre, on demande en réunion qui accompagnera la recrue sur ses premières vraies tâches, et la livraison de l’équipe tient pendant qu’elle apprend.
