Grill Me : laissez l'IA vous poser 50 questions avant d'écrire du code

Mode échec : "L'IA n'a pas fait ce que je voulais"

Le premier mode d'échec dont Matt a parlé dans son discours est le suivant : vous pensez que les exigences dans votre esprit sont très claires et laissez l'IA les écrire - ce n'est pas du tout le cas.

"I would run it, and I would try not to look at the code, but I would look at the code, and I realized I would get worse code. I did it again, I got even worse code... I did it again, kept running the compiler, and I would just end up with garbage."

De nombreuses personnes connaissent ce sentiment : si vous dites « Ajoutez un identifiant pour moi », l'IA ne vous demandera pas « Voulez-vous mémoriser l'appareil ? » « Combien de fois n'avez-vous pas réussi à verrouiller le compte ? » « Combien de temps faut-il pour que la session expire ? » Il présente directement un plan qu’il juge raisonnable. Au moment où vous le révisez, 500 lignes ont été écrites, soit deux heures de retouche.

Pourquoi cela se produit : le concept de design dévie

Matt cite le design concept (concept de design) de Frederick P. Brooks dans « The Design of Design » :

Lorsque plusieurs personnes collaborent pour concevoir quelque chose, quelque chose se crée entre vous – cela flotte dans votre esprit, une « théorie invisible sur cette chose ». Ce n'est pas un atout, ce n'est pas un atout inséré dans un fichier de démarque, c'est un consensus invisible.

L’IA écrit du code dès qu’il apparaît, ce qui signifie qu’elle ne partage pas du tout le même concept de conception avec vous. Ce qui ne va pas lors de l’écriture de code, ce n’est pas la syntaxe, mais le principe.

Pour résoudre ce problème, vous devez d’abord aligner le concept de conception avant de commencer. L'outil fourni par Brooks s'appelle arbre de conception - divise une décision en plusieurs branches, puis divise chaque branche. Vous ne pouvez pas sauter les décisions en amont et prendre directement des décisions en aval, sinon tout devra être refait une fois l'amont passé à l'aval.

Texte intégral de la compétence de Matt

L'implémentation par Matt de cette théorie dans mattpocock/skills est productivity/grill-me/SKILL.md, et l'ensemble du fichier plus le texte de référence fait moins de 15 lignes :

---
name: grill-me
description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
---

Interview me relentlessly about every aspect of this plan until we reach
a shared understanding. Walk down each branch of the design tree,
resolving dependencies between decisions one-by-one. For each question,
provide your recommended answer.

Ask the questions one at a time.

If a question can be answered by exploring the codebase, explore the
codebase instead.

Interpréter phrase par phrase :

• "interviewez-moi sans relâche" - Le mot clé est sans relâche (ne pas lâcher prise). Par défaut, LLM a tendance à poser 1 ou 2 questions, puis à se sentir « presque » et à commencer à agir. Ce mot supprime par force cette tendance.
• "descendez chaque branche de l'arbre de conception" —— Le concept d'arbre de conception de Brooks. Forcez Claude à traiter vos besoins comme un arbre, en résolvant d'abord l'amont puis l'aval. Si vous dites « Connexion », il vous demandera d'abord « Méthode d'authentification » (racine de l'arborescence), puis développera « Comment gérer la session »/« Comment enregistrer le jeton » (sous-nœud) en fonction de votre réponse.
• "résoudre les dépendances entre les décisions une par une" - Interdire explicitement les questions packagées. Il existe souvent des dépendances entre les décisions (si vous choisissez SSO, l'aval n'a pas besoin de problèmes de politique de mot de passe), assurez-vous d'abord que l'amont peut éliminer de nombreux problèmes en aval.
• "pour chaque question, fournissez votre réponse recommandée" - points bonus clés. L’IA ne se contente pas de poser des questions, mais recommande également des réponses. Il vous suffit de hocher la tête/non et d'économiser 80 % du temps de frappe.
• "posez les questions une par une" - Empêche l'IA de vous poser 10 questions à la fois.
• "Si une question peut être répondue en explorant la base de code, explorez plutôt la base de code" - S'il s'agit d'un fait qui existe déjà dans le projet (comme "Quel framework de test est utilisé dans le projet"), laissez Claude le voir lui-même, ne vous le demandez pas.

7 lignes, mais chaque phrase correspond à un biais comportemental spécifique du LLM.

Comment installer et utiliser

Installation :

npx skills@latest add mattpocock/skills

Vérifiez grill-me et setup-matt-pocock-skills (grill-me ne dépend pas de ce dernier, mais d'autres compétences en dépendent, il est donc recommandé de les installer ensemble).

Appeler : Entrez /grill-me dans la boîte de dialogue Claude Code.

Processus typique :

1. Vous décrivez ce que vous souhaitez faire, ce qui peut être très vague (« Je souhaite ajouter une fonction commentaire sur mon blog »)
2. Entrez /grill-me
3. Claude a commencé à poser les questions une par une et a recommandé des réponses à chaque question.
4. Vous répondez à chaque question une par une (acquiescement/non/correct)
5. Généralement, un consensus est atteint après 20 à 50 questions, et Claude vous fera une synthèse.
6. Le résumé peut être directement transmis à /to-prd pour devenir PRD, ou directement transmis à /tdd pour commencer la rédaction.

Cas réel : Combien coûte une fonction d'édition vidéo ?

Matt a donné quelques chiffres spécifiques dans "5 compétences d'agent que j'utilise chaque jour" :

• Nouvelle fonctionnalité d'édition vidéo - 16 questions pour parvenir à un consensus
• Fonctions complexes - 30~50 questions
• EXTRÊMEMENT COMPLEXE - 100 questions, séance jusqu'à 45 minutes

Exemple de question (restaurée à partir de la vidéo/du blog de Matt) :

• "Should video clips be reorderable, or only added/removed in sequence?"
• "When a clip is deleted, do we keep its source file, or delete the file too?"
• "Does the editor need undo/redo? How many steps deep?"
• "Should we render previews in the browser, or rely on a backend service?"

Aucun de ces problèmes n’était technique – il s’agissait uniquement de décisions relatives aux produits. Mais chaque décision détermine la forme de centaines de lignes de code. Si vous ignorez ces questions et laissez l'IA les écrire directement, elle proposera elle-même un ensemble de réponses et vous reviendrez les rejeter une par une après les avoir écrites.

Différences entre le mode Plan et le mode Plan intégré de Claude Code

Claude Code est livré avec plan mode (appuyez sur Shift+Tab pour entrer). En surface, cela ressemble à un grill-me : discutez d'abord avant d'agir. Mais Matt a dit directement dans son discours qu'il préférait me griller :

Différences spécifiques :

La plus grande différence pratique est « urgent ou non ». Le mode Plan est pressé de démarrer, grill-me n'est pas pressé - il considère « penser clairement » comme la tâche principale plutôt que comme le prologue.

Utilisation avancée

1. Scénarios sans programmation

grill-me ne lie pas de code et peut également être utilisé pour des conversations purement décisionnelles sur les produits. Matt l'utilise lui-même :

• Conception du programme de cours
• Rédaction d'articles
• Documents de communication interne

Tant que vous avez une vague idée en tête et que vous voulez être obligé d’y réfléchir, vous pouvez l’utiliser.

2. Coopérer avec /to-prd

Une fois la session grill-me terminée, dites simplement /to-prd, et Claude condensera l'intégralité de la conversation dans un PRD structuré (y compris la user story, le fractionnement des modules et la stratégie de test) et le soumettra à votre outil de suivi des problèmes. Point clé : n'effacez pas le contexte au milieu - to-prd est extrait directement du contexte de la conversation et ne vous le demandera plus.

3. Coopérer avec /grill-with-docs

Si le projet a déjà CONTEXT.md (langage du domaine) et docs/adr/ (décisions architecturales), utilisez /grill-with-docs au lieu de /grill-me. Il mettra à jour de manière synchrone CONTEXT.md tout en étant torturé - les décisions sont prises pendant que les documents sont mis à jour, et il n'y a plus le problème des "documents définitivement obsolètes".

4. Personnalisez la profondeur des questions

Si vous êtes pressé par le temps, vous pouvez ajouter une phrase directement après /grill-me : "Limitez à 10 questions, concentrez-vous uniquement sur les décisions d'architecture." Il convergera selon votre limite. Mais Matt ne le recommande pas – il pense que « poser plus de questions » est exactement la valeur de cette compétence, et l’interrompre équivaut presque au mode plan.

Notes

Ce sera ennuyeux la première fois que vous courrez. Les personnes habituées à « générer 500 lignes dans une phrase » auront le sentiment que c'est une perte de temps de se faire demander 30 fois par l'IA pour la première fois. Le conseil de Matt est de s’en tenir aux 5 premières questions – les 5 premières questions révèlent souvent des choses auxquelles vous n’avez même pas pensé. Une fois ce seuil dépassé, vous deviendrez accro.

Ne convient pas aux tâches extrêmement petites. Modifiez une faute de frappe, ajoutez un console.log - n'utilisez pas grill-me. Il convient pour « créer une nouvelle chose » ou « changer une vieille chose avec des effets secondaires ».

Parfois, l'IA demandera des détails techniques. Si vous ne vous en souciez pas et que vous voulez le laisser juger, répondez simplement « votre appel » et « vous décidez », et il l'acceptera et continuera.

Pourquoi cette compétence est-elle populaire ?

/grill-me est la compétence la plus fréquemment capturée et transmise parmi les compétences de Matt. La raison n'est pas compliquée :

1. Extrêmement minimaliste : 7 lignes de démarque, il suffit de copier et coller
2. Effet immédiat : Vous pouvez ressentir le changement dans la « densité des problèmes » de l'IA lors de la première exécution.
3. Portable : ne dépend pas de Claude Code, Codex, Cursor et Aider peuvent tous être utilisés
4. Livré avec un comportement par défaut anti-LLM : chaque mot est une déviation anti-LLM, avec une esthétique d'ingénierie élevée

Son succès est également devenu le meilleur argument pour dire que « la compétence ne doit pas nécessairement être longue ».

Ressources de référence

Article suivant : Grill With Docs : Maintenir le langage du projet et l'ADR - une version avancée de grill-me, pour les projets avec une complexité de domaine.