Explique-moi le code (L'IA comme tuteur personnel de programmation)

1. Vue d'ensemble du concept et de sa finalité

Lorsqu'un débutant commence à apprendre la programmation ou tombe par hasard sur un fichier de script sur GitHub, il voit souvent un mur indéchiffrable de symboles : async, await, map(), lambda x: x*2, accolades et flèches. Les manuels standards sont fréquemment rédigés dans un langage académique encore plus complexe, ce qui décourage rapidement l'apprenant.

L'intelligence artificielle est le professeur de programmation le plus patient au monde. Il n'y a aucune honte à poser la question la plus basique ; elle ne s'irrite jamais si vous reposez la même question dix fois de suite, et elle sait expliquer même les algorithmes quantiques via des recettes de crêpes ou les règles du football.

Dans la pratique d'ingénierie, c'est le moyen le plus rapide de comprendre un programme tiers en 5 minutes, sans appréhension face au code technique.

2. Trois niveaux d'explication pour le même code

Observez comment différentes prompts permettent d'expliquer une simple fonction :

const adults = users.filter(user => user.age >= 18);

┌─────────────────────────────────────────────────────────────┐
│                 NIVEAUX D'EXPLICATION POUR DÉBUTANT         │
├─────────────────────────────────────────────────────────────┤
│ 👶 Niveau 1 : Analogie du quotidien (pour un enfant de 10 ans) : │
│    « Imagine que le videur se tient à l’entrée d’une boîte de nuit. │
│     Il vérifie la pièce d’identité de chaque invité. Si l’invité a 18 ans, │
│     il le laisse entrer pour danser ».                       │
├─────────────────────────────────────────────────────────────┤
│ 📝 Niveau 2 : Analyse syntaxique ligne par ligne :          │
│    • `const adults` : on crée une nouvelle liste vide.      │
│    • `users.filter()` : on prend la liste de toutes les personnes et on active │
│      un tamis (filtre).                                     │
│    • `user.age >= 18` : la règle de sélection (âge supérieur ou égal à 18 ans). │
├─────────────────────────────────────────────────────────────┤
│ 💡 Niveau 3 : Pourquoi ce code est écrit ainsi (Architecture) : │
│    « Ici, on utilise une méthode déclarative plutôt qu’une boucle for. │
│     Cela rend le code plus court et protège contre la mutation de l’original ». │
└─────────────────────────────────────────────────────────────┘

3. Top-3 des prompts les plus utiles pour l'analyse de code

01. Analyse d'un script obscur écrit par autrui

Quand un collègue vous envoie un fichier sans commentaires :

« Explique-moi ce code. Structure ton explication en 3 blocs : 1. Ce que fait globalement ce script (objectif principal). 2. Les données qu'il reçoit en entrée et ce qu'il retourne en sortie. 3. Crée un tableau : chaque ligne de code ➔ explication en langage naturel ».

02. Détection des cas limites cachés (Edge Cases)

Vérifiez où votre code risque de casser :

« Regarde cette fonction. Que se passe-t-il si l'utilisateur saisit une chaîne vide, un nombre négatif ou clique deux fois de suite sur le bouton ? Comment protéger le programme contre un crash ? »

03. Traduction de code d'un langage à l'autre pour faciliter la compréhension

Si vous connaissez un peu Python mais devez comprendre du TypeScript :

« Voici du code en TypeScript. Réécris-le en Python simple et montre en parallèle : quelle construction Python correspond à chaque ligne de TypeScript ».