Technique de Feynman

L'IA vous a donné un correctif. Vous l'avez collé, ça passe. Vous ne savez toujours pas pourquoi.

Ici, on s'occupe du pourquoi.

English · 中文 · हिन्दी · Español · Français · العربية · বাংলা · Português · Русский · اردو

Même modèle. Même question. Une ligne d'installation.

« Pourquoi j'ai Cannot read properties of undefined (reading 'map') ? »

Les deux réponses sont vraies. Une seule était une explication.

D'où ça vient

Le père de Feynman lui a montré un oiseau et lui a dit qu'on peut apprendre son nom dans toutes les langues de la Terre et ne rien savoir du tout de l'oiseau. On saurait seulement comment les gens l'appellent. Pour connaître l'oiseau, il faut regarder ce qu'il fait.

"There is a difference between the name of the thing and what goes on." — Richard Feynman, What Is Science?, 1966

« Il y a une différence entre le nom de la chose et ce qui se passe. »

Toute l'idée est là, et presque toutes les IA la ratent par défaut. Demandez ce qu'est une chose : on vous rend son nom, en mots plus chics. Ce skill oblige le modèle à sortir le mécanisme d'abord, et le nom en dernier — comme le faisait Feynman.

Il est bâti sur des sources primaires, pas sur des billets de blog à propos de Feynman. Environ 88 000 mots de ses propres écrits ont été analysés pour en tirer la méthode autant que le style : Six Easy Pieces, la conférence Nobel de 1965, Cargo Cult Science, What Is Science?, There's Plenty of Room at the Bottom et le chapitre brésilien de Surely You're Joking, Mr. Feynman!

Le dépôt est en anglais. Les réponses, non — le skill répond dans la langue que vous employez pour lui écrire.

Les quatre tests qu'il applique

Pas la version qui circule sur les blogs. Ce sont les tests de Feynman lui-même, chacun remontant à une source primaire.

Installation

Un seul dossier à copier. Ça marche dans tout outil qui gère le standard ouvert Agent Skills.

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.claude/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.claude/skills/

Ça, c'est Claude Code. Ensuite, il suffit de demander :

/feynman-technique explique comment fonctionnent les index de base de données

mkdir -p .claude/skills
cp -r /tmp/feynman-technique/skills/feynman-technique .claude/skills/

./install.sh              # personnel, Claude Code
./install.sh --project    # dans ce dépôt, pour l'équipe
./install.sh --all        # tous les dossiers d'outils présents sur la machine
./install.sh --check      # signale les copies en retard, sans rien modifier

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.agents/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.agents/skills/

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.cursor/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.cursor/skills/

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.copilot/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.copilot/skills/

git clone https://github.com/guicortei/feynman-technique.git /tmp/feynman-technique
mkdir -p ~/.gemini/skills
cp -r /tmp/feynman-technique/skills/feynman-technique ~/.gemini/skills/

~/.agents/skills/        # la convention qui s'impose entre outils
~/.claude/skills/        # largement pris en charge en repli
<propre-à-l-outil>/skills/  # ex. ~/.gemini/skills/, ~/.cursor/skills/

Vérifier que ça marche

Posez une question sur un sujet que vous maîtrisez déjà :

/feynman-technique qu'est-ce qu'une fonction de hachage ?

Une réponse correcte s'ouvre sur une thèse d'une phrase, enchaîne sur un niveau 0 sans le moindre mot technique et se termine par une section « où l'image casse ». Si elle démarre par « Une fonction de hachage est une fonction qui associe des données de taille arbitraire… », c'est que le skill ne s'est pas chargé.

Ce que vous recevez

**En une phrase :** ...           ← pour qu'un expert puisse s'arrêter là

**L'image à garder en tête :** ...  ← l'analogie maîtresse

0 · Repas de famille   aucune connaissance du domaine. Zéro terme technique.
1 · Nouveau venu       les vrais noms, rattachés à l'image du niveau 0
2 · Praticien          comment les pièces s'emboîtent, et le premier vrai compromis
3 · Mainteneur         modes de défaillance, ce qui casse, ce qui a été écarté et pourquoi
4 · Spécialiste        cas limites, montée en charge, et les limites du modèle lui-même

Où l'image casse            ← les limites de toute analogie, énoncées
Mots introduits ici         ← une ligne par terme nouveau
Ce que j'ai laissé de côté  ← nommé, pas passé sous silence

Les niveaux se compriment, mais ne disparaissent jamais. Une question étroite reçoit la forme compacte : thèse, image, le seul niveau qui compte. Faire défiler cinq niveaux à un expert, ce n'est pas de la rigueur ; cela dégrade sa compréhension, et de façon mesurable : c'est l'effet d'inversion de l'expertise.

Voir l'exemple complet : « qu'est-ce qu'un index de base de données ? », traité de bout en bout, puis annoté pour montrer ce que fait chaque partie.

Mode coach — celui qui vous apprend vraiment

/feynman-technique interroge-moi sur la gestion de la congestion par TCP
/feynman-technique je veux vérifier si je comprends vraiment l'event sourcing

Là, le skill refuse d'expliquer. C'est vous qui expliquez ; lui, il écoute. Il guette le flou, les termes techniques posés comme point final, les étapes affirmées sans mécanisme — puis il montre du doigt une lacune, une seule à la fois, sans vous donner la réponse.

C'est le mode que la recherche appuie le plus solidement. Ceux qui se préparent à enseigner obtiennent de meilleurs résultats que ceux qui se préparent à un examen, même quand l'enseignement n'a jamais lieu (Nestojko et al., 2014). Fabriquer sa propre explication vaut mieux que lire celle d'un autre (Chi et al., 1989).

Les règles qu'il suit

Règle zéro : être clair n'excuse jamais d'avoir tort. Si simplifier revient à déformer, le skill le dit, donne les limites, et livre la version exacte au barreau du dessus.

Sous le capot

Les fichiers du skill sont en anglais, pour que le frontmatter reste canonique.

Un aperçu de l'analyse stylistique

Extrait de voice.md, tout mesuré sur le corpus de 88 000 mots :

• La rupture de rythme est la signature. Phrase médiane ≈ 20 mots — mais environ 1 sur 8 tient en moins de huit mots et 1 sur 6 dépasse les trente-cinq. Il construit long, il atterrit court. "Shake this one, that one shakes later." — « Secouez celui-ci, l'autre bougera plus tard. »
• Les pronoms changent selon la fonction. « We » quand il enseigne (19,95 pour 1 000 mots dans Six Easy Pieces, dix fois plus que ses « I »), « I » quand il avoue sa confusion (26,7/1k dans la conférence Nobel), « you » quand il donne des consignes (20,6/1k dans Cargo Cult Science).
• Des verbes qu'un corps peut sentir. jiggle 27, pull 37, push 28, shake 20. Les molécules frétillent ; elles ne « manifestent » aucune « agitation thermique ».
• « Basically » n'apparaît pas une seule fois en 88 000 mots. Trivial apparaît une fois. D'où l'interdiction de ces mots dans le skill : c'est une mesure, pas une question de goût.

Limites assumées

La règle zéro vaut aussi pour cette page.

• Feynman n'a pas inventé la « technique de Feynman ». Il n'a jamais publié de méthode en quatre étapes portant ce nom. Ces quatre étapes ont été assemblées plus tard par des vulgarisateurs, Scott H. Young au premier chef, vers 2011 — une reconstruction honnête. Ce skill s'appuie plutôt sur ses tests documentés, et le dit.
• « Si vous ne pouvez pas l'expliquer simplement, c'est que vous ne l'avez pas compris » n'a aucune source primaire, ni chez Feynman ni chez Einstein. sources.md recense ce qu'il a dit de vérifiable, et ce qu'il n'a jamais dit.
• Certaines choses ne se simplifient pas. Feynman s'est cogné lui-même à ce mur : quand son propre père lui a demandé comment un photon sort d'un atome sans y avoir jamais été, il a répondu "I'm sorry; I don't know. I can't explain it to you." — « Désolé ; je ne sais pas. Je ne peux pas te l'expliquer. » Le skill est fait pour dire cela plutôt que de fabriquer une image.
• Cela coûte des tokens et du temps. Pour une simple vérification, la forme compacte — ou pas de skill du tout — reste le bon choix.
• Il n'apporte pas grand-chose à la mémorisation ni aux automatismes moteurs. Il vise la compréhension causale, mécanique. Le vocabulaire et les raccourcis clavier réclament de la récupération espacée, pas des explications.
• Une bonne explication donne l'impression d'avoir compris. Cette impression ne prouve rien. Quand l'enjeu compte, passez en mode coach.

Crédits et droits d'auteur

Richard P. Feynman (1918–1988) a écrit tout ce qui, ici, vaut la peine d'être lu. Ce dépôt contient des règles dérivées et de courtes citations attribuées, à des fins d'analyse et d'enseignement — il ne redistribue pas son œuvre.

Ses textes restent sous copyright : The Feynman Lectures on Physics se lit gratuitement sur feynmanlectures.caltech.edu, mais le texte est © Caltech et n'appartient pas au domaine public. Si vous forkez ce dépôt, tenez la même ligne : citez court, attribuez toujours, ne recopiez jamais de chapitres. Provenance complète dans sources.md.

Ce skill a commencé sous le nom de feynman-reply, un skill en portugais signé @guicortei. Il a été reconstruit à partir des sources primaires, élargi au-delà du logiciel, puis enrichi de l'analyse stylistique, de la base de preuves et du mode coach — et rebaptisé feynman-technique.

Ce projet n'est ni affilié ni approuvé par la succession Feynman, Caltech ou Anthropic.

Contribuer

Les contributions sont bienvenues — en particulier :

• des exemples traités dans d'autres domaines (médecine, droit, finance, biologie)
• des modes d'échec rencontrés en usage réel
• des corrections sur une citation ou une attribution

Voir CONTRIBUTING.md. Une demande, une seule : si vous ajoutez une affirmation sur Feynman, citez la source primaire. Bâcler l'attribution tout en invoquant son nom au nom de l'honnêteté intellectuelle, c'est le seul bug impardonnable de ce dépôt.

Licence

MIT. Utilisez-le, forkez-le, diffusez-le.