Publié le · Sources lues le 11 novembre 2026 · Lecture : 12 min
Chaque idée de ce livret renvoie à une source publique que tu peux ouvrir : le repo GitHub de Matt Pocock, ses articles ou ses pages officielles. Rien n'est tiré de mémoire.
Points essentiels à retenir :
- Pour Matt Pocock, les fondamentaux du génie logiciel comptent plus que jamais. Il le résume ainsi dans le README de son dépôt : « Software engineering fundamentals matter more than ever ».
- Il identifie quatre pannes typiques des agents de code : l'agent ne fait pas ce que tu voulais, il est trop bavard, son code ne marche pas, et le projet finit en « ball of mud », c'est-à-dire en code spaghetti : un code sans architecture claire, où tout dépend de tout.
- Pour chaque panne, il propose un remède : faire interroger l'agent avant qu'il code, partager un glossaire du projet, lui donner des boucles de retour (types, tests, navigateur) et soigner la conception du code tous les jours.
- Ses skills se veulent petits et combinables entre eux : c'est toi qui gardes la main sur le processus, pas l'outil.
- Son dépôt
mattpocock/skillsenchaîne/grill-me,/to-spec,/to-ticketset/implementpour aller de l'idée au code relu.
1. À propos de ce livret
- Citations : entre guillemets, en anglais d'origine, avec le lien. La traduction française est la mienne.
- Interprétations : signalées par « À retenir ». Ce sont mes propositions, pas les mots de Pocock.
2. Qui est Matt Pocock
Matt Pocock se présente comme « the creator of Total TypeScript and AI Hero », c'est-à-dire le créateur de Total TypeScript et d'AI Hero, selon sa page d'orateur AI Engineer. Cette même page explique que son travail sur l'IA « applies software-design principles to the requirements, architecture, testing, and review surrounding coding agents' implementation work » : il applique les principes de conception logicielle à tout ce qui entoure le travail des agents de code, c'est-à-dire l'expression du besoin, l'architecture, les tests et la relecture.
| Période | Ce qu'il a fait | Source |
|---|---|---|
| Avant le code | Professeur de voix, de chant et de prise de parole | AI Engineer |
| 2021 | Rejoint Stately, dans l'équipe cœur de XState | AI Engineer |
| Ensuite | Developer advocate chez Vercel | AI Hero, The Pragmatic Engineer |
| Ensuite | Crée Total TypeScript, qui a dépassé 2,5 millions de dollars de ventes | The Pragmatic Engineer |
| Aujourd'hui | Directeur d'AI Hero, qu'il décrit comme « the engineering process for working with coding agents, from an idea to shipped, reviewed code » (une méthode d'ingénierie pour travailler avec des agents de code, de l'idée jusqu'au code livré et relu) | AI Hero |
Pourquoi l'écouter : il publie ses skills en open source sur mattpocock/skills et y documente chaque décision. Son README revendique une newsletter suivie par environ 60 000 développeurs.
3. Les thèses : quatre pannes des agents de code, quatre remèdes
La thèse centrale tient en une phrase du README de mattpocock/skills : « Software engineering fundamentals matter more than ever », c'est-à-dire que les fondamentaux du génie logiciel comptent plus que jamais. Ses skills servent à « do real engineering - not vibe coding » : faire de la vraie ingénierie, pas du code « au feeling ».
Il part de quatre pannes qu'il observe chez Claude Code, Codex et les autres agents. Chaque panne s'appuie sur un livre de référence.
| Panne | Citation qu'il pose en ouverture | Son remède | Skills |
|---|---|---|---|
| 1. L'agent n'a pas fait ce que je voulais | « No-one knows exactly what they want » (personne ne sait exactement ce qu'il veut) — Thomas & Hunt, The Pragmatic Programmer | Une séance d'interrogatoire (grilling) avant de coder | grill-me, grill-with-docs |
| 2. L'agent est beaucoup trop bavard | Langage omniprésent (ubiquitous language) — Eric Evans, Domain-Driven Design | Un glossaire partagé du projet (GLOSSARY.md) |
grill-with-docs, domain-modeling |
| 3. Le code ne marche pas | « The rate of feedback is your speed limit » (la fréquence des retours fixe ta vitesse maximale) — Thomas & Hunt | Des boucles de retour : types, navigateur, tests en rouge → vert | tdd, diagnosing-bugs |
| 4. On a construit un “ball of mud” (un code spaghetti, sans architecture claire) | « Invest in the design of the system every day » (investis chaque jour dans la conception du système) — Kent Beck ; « The best modules are deep » (les meilleurs modules sont profonds) — John Ousterhout | Soigner la conception du code, tous les jours | to-spec, improve-codebase-architecture |
Thèse 1 : le vrai problème est le désalignement
Pour lui, « the most common failure mode in software development is misalignment », c'est-à-dire que la panne la plus fréquente en développement logiciel est le désalignement entre ce que tu veux et ce qui est construit. C'est vrai avec un développeur, et c'est pareil avec un agent.
À propos des skills d'interrogatoire, il conseille : « Use them every time you want to make a change », c'est-à-dire de les utiliser chaque fois que tu veux modifier quelque chose.
À retenir : l'agent doit te poser des questions avant de coder, pas après.
Thèse 2 : un langage partagé rend l'agent concis
Un agent déposé dans un projet doit deviner le jargon. Résultat, selon Pocock, il « use[s] 20 words where 1 will do », c'est-à-dire qu'il emploie vingt mots là où un seul suffirait. Son exemple : la périphrase « a lesson inside a section of a course is made 'real' (i.e. given a spot in the file system) », soit « une leçon d'une section de cours devient réelle, autrement dit elle reçoit un emplacement dans le système de fichiers », est remplacée par un seul terme du projet : « the materialization cascade » (la cascade de matérialisation).
Il écrit que cette technique « might be the single coolest technique in this repo », c'est-à-dire qu'elle est peut-être la plus intéressante de tout son dépôt. Les bénéfices qu'il cite : noms cohérents dans le code, code plus facile à parcourir, moins de tokens dépensés.
Un extrait de glossaire pour ce blog :
# GLOSSARY.md, blog amaliamaturana.com
Article : un contenu pédagogique publié dans /classes/, avec son fichier classes/<slug>.php.
Chapitre : un article enfant d'un article parent ; il n'a pas de thématique propre et n'apparaît pas dans la grille de /enseignement.
Thématique : la catégorie d'un article (frontend, IA…), affichée en filtre sur /enseignement.
Encart DevToTop : le bloc de fin d'article qui renvoie vers devtotop.com.
Avec ce fichier, il suffit de dire « ajoute un chapitre à cet article » : l'agent sait qu'il faut un post enfant, un fichier PHP et aucune thématique.
À retenir : un fichier qui définit tes mots métier fait gagner du temps à chaque session.
Thèse 3 : sans retour, l'agent vole à l'aveugle
Si l'agent ne voit pas comment son code tourne, Pocock écrit qu'il « will be flying blind », c'est-à-dire qu'il volera à l'aveugle. Les boucles qu'il cite : types statiques, accès au navigateur, tests automatisés.
Pour les tests, il écrit qu'« a red-green-refactor loop is critical », c'est-à-dire qu'une boucle rouge, vert, refactor est indispensable : l'agent écrit d'abord un test qui échoue, puis le fait passer.
L'exemple que donne Pocock dans son skill tdd :
// Test tautologique : il recalcule le résultat comme le code
it('additionne deux nombres', () => {
const a = 2;
const b = 3;
expect(add(a, b)).toBe(a + b);
});
// Test utile : il compare à une valeur connue à l'avance
it('additionne deux nombres', () => {
expect(add(2, 3)).toBe(5);
});
Le premier test répète la logique du code : si cette logique est fausse, le test l'est aussi, et il passe quand même. Le second compare à un résultat connu, établi sans regarder le code.
Pour visualiser : la boucle rouge, vert
tdd en juin 2026 : le refactoring passe par code-review.Chaque tour ajoute un seul comportement, prouvé par un test que tu as vu échouer.
À retenir : un test qu'on n'a jamais vu échouer ne prouve rien.
Thèse 4 : l'IA accélère l'entropie
Pocock appelle sa 4e panne « We Built A Ball Of Mud », c'est-à-dire « on a construit une grosse boule de boue ». L'expression « Big Ball of Mud » est un classique du génie logiciel : elle désigne un code sans architecture claire, où tout dépend de tout, et que plus personne n'ose modifier.
Il part d'un constat : « Because agents can radically speed up coding, they also accelerate software entropy », c'est-à-dire que les agents accélèrent l'écriture du code, et donc aussi le désordre qui s'y installe. Son remède, qu'il qualifie lui-même de radical, tient en une expression : « caring about the design of the code », c'est-à-dire prendre soin de la conception du code.
La notion clé vient d'Ousterhout : le module profond, beaucoup de comportement derrière une petite interface. Il recommande de lancer improve-codebase-architecture « once every few days », c'est-à-dire tous les deux ou trois jours, tout en précisant : « It is a survey, not a rescue » ; autrement dit, c'est un état des lieux, pas une opération de sauvetage.
Pour visualiser : module profond ou module mince
Un module profond cache sa complexité derrière une petite interface : il y a moins à comprendre, pour toi comme pour l'agent.
À retenir : plus l'IA code vite, plus la conception compte.
Une position de méthode : petit et composable
Il se démarque des méthodes GSD, BMAD et Spec-Kit. Selon lui, elles « try to help by owning the process », c'est-à-dire qu'elles veulent aider en prenant en charge tout le processus, mais elles « take away your control » : elles te retirent le contrôle. Ses skills, au contraire, se veulent « small, easy to adapt, and composable », c'est-à-dire petits, faciles à adapter et combinables entre eux, et ils « work with any model » : ils fonctionnent avec n'importe quel modèle.
À retenir : tu gardes la main sur le processus ; les skills sont des briques, pas une méthode imposée.
4. Le repo mattpocock/skills : les skills clés
Le repo contient une vingtaine de skills actifs, classés en engineering et productivity (état lu le 11/11/2026, dernier commit du 31/10/2026). Les cinq ci-dessous sont les plus utiles au quotidien.
Installation dans Claude Code (d'après le README) :
claude plugin install mattpocock-skills@claude-plugins-official
Puis, une fois par dépôt, lancer /setup-matt-pocock-skills : il demande quel gestionnaire de tickets tu utilises, tes labels de tri et où ranger les documents.
La chaîne complète, de l'idée au code relu
/grill-meou/grill-with-docs: s'aligner sur ce qu'on construit./to-spec: transformer la conversation en spécification, avec les points de test (seams) convenus./to-tickets: découper en tickets verticaux, chacun avec ce qui le bloque./implement: construire ticket par ticket, en appelanttddpuiscode-reviewavant de commiter.
Pour visualiser : la chaîne complète
À chaque flèche, c'est toi qui valides : l'agent ne construit qu'une fois l'idée clarifiée, spécifiée et découpée.
Les skills, un par un
| Skill | Ce qu'il fait (d'après le repo) | La règle à retenir |
|---|---|---|
| grill-me | Sa consigne : « Interview the user relentlessly until you reach a shared understanding » (interroger l'utilisateur sans relâche jusqu'à une compréhension commune). Questions par tours, chacune avec sa réponse recommandée. | L'agent cherche les faits lui-même ; les décisions restent les tiennes. |
| tdd | Une boucle rouge → vert, une tranche verticale à la fois. | « Test only at pre-agreed seams » (ne tester qu'aux points convenus à l'avance) : aucun test à un endroit que tu n'as pas validé. |
| to-tickets | Découpe un plan en tickets « tracer bullet » (balle traçante : une tranche fine qui traverse tout le système), chacun démontrable seul. | Chaque ticket traverse toutes les couches et tient dans une seule session. |
| code-review | Relit le diff sur deux axes, Standards et Spec, avec deux sous-agents séparés. | Ne jamais fusionner les deux verdicts : un axe réussi cacherait l'autre. |
| improve-codebase-architecture | Cherche les modules trop « minces » et rend un rapport HTML de pistes. | Commencer par les fichiers qui changent le plus souvent dans l'historique git. |
Pour visualiser : couches ou tranche verticale
Chaque tranche traverse tout le système : tu as un retour réel dès la première.
Trois détails qui changent la pratique
- Pas de phase « refactor » dans
tdd. La doc du skill indique qu'elle a été retirée en juin 2026 « because agents almost never performed it », c'est-à-dire parce que les agents ne la faisaient presque jamais. Le refactoring passe danscode-review. - Trois anti-modèles de tests. Un test collé à l'implémentation, un test tautologique (qui recalcule le résultat comme le code), et tous les tests écrits avant tout le code.
- Le piège de
grill-me: la passivité. Sa doc décrit le piège : répondre « agreed, agreed, agreed » (d'accord, d'accord, d'accord) à quarante questions. Elle conclut : « This skill helps an engineer and does not replace one », c'est-à-dire que ce skill aide un ingénieur mais ne le remplace pas.
Ce qu'en disent ses articles
- Tracer Bullets: Keeping AI Slop Under Control (mis à jour le 22/01/2026) : Pocock y conseille de travailler par tranches : « Instead of building horizontal layers in isolation, you build one tiny vertical slice », c'est-à-dire qu'au lieu de construire chaque couche séparément, on construit une toute petite tranche verticale qui les traverse toutes. Puis on teste, on obtient un retour, et on passe à la tranche suivante « in a fresh context window », c'est-à-dire dans une nouvelle conversation, avec un contexte vierge.
- My 'Grill Me' Skill Went Viral (mis à jour le 23/03/2026) : il écrit que ce skill est « fantastic in the early phase of coding, because you need to discover all of the requirements by talking them through », c'est-à-dire excellent au début d'un projet, parce qu'il faut découvrir tous les besoins en les discutant.
- AI Skills with Matt Pocock, The Pragmatic Engineer, 17/09/2026 : il estime que les agents sont « more than capable of tactical programming », c'est-à-dire largement capables de programmation tactique, autrement dit d'écrire le code d'une tâche précise. Il leur demande désormais de prouver que leur code fonctionne.
À retenir
- Les fondamentaux comptent plus que jamais : faire de la vraie ingénierie, pas du code « au feeling ».
- S'aligner avant de coder : l'agent doit te poser des questions avant de coder, pas après.
- Partager un langage : un fichier qui définit tes mots métier fait gagner du temps à chaque session.
- Donner des retours à l'agent : types, navigateur, tests en rouge → vert.
- Soigner la conception : plus l'IA code vite, plus la conception compte.
Sources
Toutes les sources ci-dessous ont été ouvertes et lues le 11/11/2026.
Sources primaires (Matt Pocock)
- mattpocock/skills, README : commit
4ae2317, du 31/10/2026 - Skill grilling et doc de grill-me
- Skill tdd et doc de tdd
- Skill to-tickets
- Skill code-review et doc de code-review
- Skill improve-codebase-architecture et skill codebase-design
- Tracer Bullets: Keeping AI Slop Under Control, aihero.dev, mis à jour le 22/01/2026
- My 'Grill Me' Skill Went Viral, aihero.dev, mis à jour le 23/03/2026
- AI Hero, page d'accueil
Sources secondaires
- AI Skills with Matt Pocock, Gergely Orosz, The Pragmatic Engineer, 17/09/2026
- Vidéo de l'épisode AI Skills with Matt Pocock, The Pragmatic Engineer, YouTube
- Matt Pocock, page d'orateur, AI Engineer