Réduire drastiquement le temps d'onboarding des nouveaux ingénieurs avec Claude Code

Le temps de montée en compétence d’un nouvel ingénieur est un coût énorme dans toute entreprise. Bases de code massives, docs éparpillées, savoir tribal. Faites de Claude Code le copilote du nouvel arrivant et 3 mois de montée en compétence deviennent 2 semaines.

1. Finaliser la configuration de l’environnement en une demi-journée

Le setup est le premier mur. Au lieu de solliciter les seniors sur Slack :

# Le nouvel arrivant exécute ceci sur son Mac
claude -p "
Guide-moi pour configurer l'environnement de développement de ce repo
(https://github.com/our-org/main-app) sur macOS.

Pour chaque étape :
1. Outils requis (avec versions)
2. Commandes d'installation
3. Variables d'environnement à configurer
4. Comment vérifier que ça tourne
5. Erreurs courantes et correctifs

Lis .env.example et README ; sois concret.
"

Les DM Slack aux seniors chutent drastiquement.

2. Appréhender la base de code en 5 minutes

Les repos géants deviennent digestes.

claude -p "
Explique la structure globale de ce repo :

1. Arborescence des dossiers et rôle de chacun
2. Points d'entrée principaux
3. Flux de données (comment une requête est traitée)
4. Intégrations externes (BDD, APIs, files)
5. Cinq fichiers que je devrais lire en premier

Propose aussi un ordre de lecture qui permet à un nouvel
arrivant de toucher au code dès la première semaine.
"

Combinez avec Navigation de base de code pour un effet maximal.

3. Convertir le savoir tribal en documentation

Faites émerger le “pourquoi c’est comme ça” que seuls les vétérans connaissent.

claude -p "
Pour src/services/billing/LegacyInvoiceService.ts,
déduis à partir de git log --follow + blame :

1. Pourquoi la conception a fini ainsi
2. Pièges lors des modifications (patterns de bugs historiques)
3. Services liés
4. Ce qu'il faut revérifier avant d'y toucher

Écris la sortie dans docs/onboarding/legacy-notes.md
dans un format que les coéquipiers peuvent facilement annoter.
"

Utilisez la sortie comme fil de discussion dans GitHub Discussions — cela nourrit une documentation pilotée par la revue.

4. Recommander automatiquement les premiers PR candidats

Trouvez des tâches petites et sûres pour le nouvel arrivant.

claude -p "
Suggère 5 candidats pour un premier PR sur ce repo :

Critères :
- Changements isolés (peu d'effets de bord)
- Tests existants couvrent la zone
- Pas de logique métier centrale
- Diff entre 30 et 100 lignes

Regarde les tendances good-first-issue,
les commentaires TODO/FIXME, et les petits candidats au refactor.
Pour chacun, ajoute l'effort estimé et ce que cela apprend.
"

5. Auto-review avant de soumettre un PR

Réduit les allers-retours pour les nouveaux arrivants.

claude -p "
Inspecte git diff origin/main...HEAD.
Auto-review comme nouvel arrivant avant d'ouvrir le PR :

1. Violations des règles CLAUDE.md
2. Nommages étranges
3. Tests manquants
4. Incohérences de style avec le code existant
5. Préoccupations de sécurité

Liste uniquement les points à modifier, avec priorité.
"

Les allers-retours de revue s’effondrent. Voir Code Review avec Claude.

6. Culture “Demandez d’abord à Claude”

Consignez-le dans CLAUDE.md.

## Guide Q&A d'Onboarding

### Demande d'abord à Claude Code
- Comment le code fonctionne
- Signification des erreurs
- Raisons de conception (via git log + blame)
- Utilisation des outils

### Escalade vers Slack #dev-help uniquement pour
- Interprétation des règles métier
- Arbitrages de priorité
- Tâches nécessitant un accès restreint

### En interrogeant un senior, inclus
1. Ce que tu essaies de faire
2. Ce que tu as essayé (y compris la réponse de Claude)
3. Où tu es bloqué

Cela seul réduit les interruptions des seniors d’environ 30 %.

7. Générer automatiquement des rétrospectives hebdomadaires

Pour les 1:1 avec le mentor.

claude -p "
Résume mon activité de la semaine écoulée :

- git log --author='new-hire-name' --since='1 week ago'
- PRs créés + statut
- Tendances dans les retours de revue
- Où j'ai coincé (déduit des messages de commit)

Suggère 3 sujets à aborder au 1:1 avec le mentor.
"

Le nouvel arrivant obtient une méta-vue de sa propre progression.

Anti-patterns

❌ Tout laisser à Claude

Claude ne fait qu’inférer le savoir tribal. Vérifiez toujours le “pourquoi” métier avec des experts humains du domaine.

❌ Bloquer trop fortement les questions

Exiger “demande à Claude” de manière excessive isole le nouvel arrivant. Programmez des 1:1 agressifs les 2 premières semaines.

❌ Négliger la maintenance des docs

Les notes de savoir tribal générées par Claude pourrissent si elles sont laissées seules. Revues d’équipe à cadence régulière.

Conclusion

• Setup d’environnement en self-service en une demi-journée
• Comprendre la base de code en 5 minutes
• Convertir le savoir tribal en docs
• Auto-recommandation des premiers PR candidats
• Moins d’allers-retours de PR grâce à l’auto-review
• Moins d’interruptions des seniors via la culture “Claude d’abord”
• Génération auto des rétros hebdomadaires

Montée en compétence plus rapide = moins de charge mentor + plus de débit d’équipe.

Liens : Navigation de base de code / Code Review / Collaboration d’équipe

Docs officielles : Anthropic Claude Code