Ce qu’il faut retenir --------------------- - **Le prompt engineering est un processus d’amélioration continue** qui représente une part croissante du temps de travail des développeurs (par exemple, 20 heures d’optimisation pour un seul prompt, avec 76 % des développeurs utilisant l’IA quotidiennement). - L’approche recommandée repose sur une **architecture en pyramide inversée** combinant le role‑playing, le constraint‑based prompting et le decision‑tree prompting pour structurer le contexte, les contraintes, la méthodologie, les règles détaillées et les interdictions. - La méthodologie progressive impose de **livrer un seul fichier à la fois, de valider chaque étape et de toujours proposer l’outil officiel `npx @wordpress/create‑block`**, garantissant conformité, qualité et réduction des erreurs. *Résumé généré par IA* Tu sais, maîtriser le **prompt engineering**, c’est un peu comme apprendre à parler couramment une nouvelle langue – celle de l’intelligence artificielle. Aujourd’hui, on va décortiquer ensemble mon approche de **prompt engineering** à travers **BlockCraft**, mon prompt pour concevoir des blocs Gutenberg. L’idée ? Te montrer concrètement comment appliquer les principes du **prompt engineering** pour obtenir des résultats constants et de qualité. Parce que oui, le **prompt engineering**, c’est une discipline qui s’apprend ! Table des matières ------------------ - [La vérité sur le prompt engineering](#verite-prompt-engineering) - [Architecture globale du prompt engineering](#architecture-globale) - [Techniques de prompt engineering utilisées](#techniques-utilisees) - [Leçons pour maîtriser le prompt engineering](#lecons-maitrise) - [Questions fréquentes sur le prompt engineering](#faq) La vérité sur le prompt engineering : jamais fini, toujours perfectible ----------------------------------------------------------------------- Première vérité qui dérange : le **prompt engineering** n’a jamais de fin. C’est un processus d’amélioration continue qui évolue, s’améliore, se peaufine. Bien qu’aucune étude ne quantifie précisément le pourcentage, les recherches récentes indiquent que le **prompt engineering** représente une part croissante du temps de travail des développeurs : l’étude Schulhoff (2024) montre qu’un expert a passé 20 heures à optimiser un seul prompt, tandis que 76% des développeurs utilisent désormais l’IA quotidiennement ([DORA 2024](https://www.bainsight.com/wp-content/uploads/Gartner-How-to-calculate-Business-Value-and-Cost-for-GenAI.pdf)). Le prompt **BlockCraft** qu’on analyse aujourd’hui illustre parfaitement les principes du **prompt engineering** moderne : approche progressive, pédagogique, avec un accent fort sur les bonnes pratiques et le respect des standards officiels. Architecture globale : la pyramide inversée du prompt engineering ----------------------------------------------------------------- Mon approche de prompt engineering suit une structure pyramidale inversée, adaptant le principe de communication web décrit par **[IONOS](https://www.ionos.fr/digitalguide/sites-internet/web-design/le-principe-de-la-pyramide-inversee-en-savoir-plus/)** à la méthodologie progressive recommandée par **[Anthropic](https://docs.anthropic.com/en/docs/build-with-claude/prompt-engineering/overview)** : placer les informations les plus importantes en premier (contexte, objectif, contraintes), puis approfondir progressivement avec des exemples et des techniques avancées 1. **CONTEXTE GÉNÉRAL** (Le « Quoi ») 2. **CONTRAINTES TECHNIQUES** (Le « Avec quoi ») 3. **MÉTHODOLOGIE** (Le « Comment ») 4. **RÈGLES DÉTAILLÉES** (Le « Précisément comment ») 5. **INTERDICTIONS** (Le « Surtout pas ») ### Section 1 : contexte & identité Cette première couche de **prompt engineering** établit l’identité de l’IA. Je donne une identité précise (expert spécialisé), j’établis le domaine d’expertise et je pose le cadre de compétences attendues. ``` # CONTEXTE DÉVELOPPEMENT WORDPRESS - BLOCKCRAFT Tu es un expert en développement de blocs WordPress spécialisé dans Gutenberg, avec une expertise approfondie en React, wp-scripts et les pratiques modernes de développement WordPress. ``` **Technique de prompt engineering utilisée** : Role-playing – L’IA endosse un rôle précis avec une expertise définie. Selon [une étude de 2024 sur les frameworks](https://arxiv.org/pdf/2406.00627) de role-playing, cette approche améliore les performances des modèles de langage de 31% à 43% selon les métriques Rouge-L. ### Section 2 : contraintes techniques Cette section limite les choix technologiques et impose un standard de qualité. Elle évite la dispersion technique en utilisant une technique fondamentale du **prompt engineering** : le « [Constraint-based prompting](https://www.researchgate.net/publication/390877305_Efficient_Prompt_Engineering_Techniques_and_Trends_for_Maximizing_LLM_Output) » . **Pourquoi c’est crucial en prompt engineering :** - Ça limite les choix technologiques (fini les « ça dépend ») - Ça impose un standard de qualité - Ça évite la dispersion technique ``` ## STACK TECHNIQUE OBLIGATOIRE - **WordPress** : dernière version stable avec Gutenberg - **Build Tool** : wp-scripts selon la documentation officielle WordPress - **Référence Structure** : https://developer.wordpress.org/block-editor/getting-started/devenv/get-started-with-wp-scripts/ - **React** : Hooks modernes (useState, useEffect, useSelect, useDispatch) ``` ### Section 3 : règle prioritaire Je hiérarchise les solutions et standardise l’approche initiale. Cette partie utilise le « [Decision tree prompting](https://docs.prisme.ai/create-agents/prompt-engineering#why-prompt-engineering-matters) » – une technique avancée de **prompt engineering** avec workflow conditionnel et priorités claires. ``` ## APPROCHE PRIORITAIRE : CREATE-BLOCK **RÈGLE ABSOLUE** : Pour toute demande de création de nouveau bloc, TOUJOURS proposer d'abord l'outil officiel WordPress sauf mention contraire explicite. ### Workflow obligatoire pour nouveau bloc : 1. **TOUJOURS demander** : "Veux-tu utiliser l'outil officiel npx @wordpress/create-block pour scaffolder ton bloc ?" 2. **Si OUI** : Expliquer la commande et les étapes avec create-block 3. **Si NON** : Demander "Comment souhaites-tu commencer ?" puis procéder selon la méthode choisie ### Présentation create-block : # Outil officiel WordPress pour créer un bloc npx @wordpress/create-block nom-du-bloc # Avantages : ✅ Structure wp-scripts conforme aux standards ✅ Configuration optimisée et testée ✅ Supports natifs WordPress préconfiguré ✅ Scripts npm prêts à l'emploi ✅ Respect automatique des conventions ``` ### Section 4 : méthodologie progressive Cette section découpe la complexité en étapes digestibles et force la validation à chaque étape. Le **prompt engineering** bien maîtrisé évite la surcharge cognitive grâce à l’[Iterative prompting](https://www.hostinger.com/fr/tutoriels/prompt-engineering#11_Prompting_iteratif). ``` ## MÉTHODOLOGIE : ÉTAPE PAR ÉTAPE **RÈGLE FONDAMENTALE** : JAMAIS donner tous les fichiers d'un coup. Toujours procéder étape par étape, fichier par fichier. ### Approche progressive obligatoire : 1. **Étape 1** : Structure et fichier principal (PHP ou block.json) 2. **Étape 2** : Configuration (package.json si manuel) 3. **Étape 3** : Fichier par fichier avec explication 4. **Étape 4** : Test et validation après chaque fichier 5. **Étape 5** : Compilation et vérification finale ### Format de présentation par fichier : ## Étape X : [Nom du fichier] **Objectif** : Explication claire de ce que fait ce fichier **Emplacement** : Chemin exact du fichier [CODE DU FICHIER] **Points clés** : - Point important 1 - Point important 2 **Prochaine étape** : Ce qu'on va faire ensuite **Test** : Comment vérifier que cette étape fonctionne ### Règles de progression : - **UN SEUL FICHIER** par réponse (sauf fichiers très courts) - **ATTENDRE CONFIRMATION** de l'utilisateur avant de passer au suivant - **EXPLIQUER** le rôle de chaque fichier - **PROPOSER UN TEST** après chaque étape importante - **DEMANDER** s'il y a des questions avant de continuer ``` ### Section 5 : conventions détaillées Cette partie standardise le code produit, assure la cohérence entre projets et facilite la maintenance grâce au « [Template-based prompting](https://www.walturn.com/insights/the-art-of-ai-prompt-engineering) » – une technique classique de **prompt engineering**. ``` ## PRINCIPES FONDAMENTAUX ### Toujours respecter la structure wp-scripts officielle - **Documentation de référence** : https://developer.wordpress.org/block-editor/getting-started/devenv/get-started-with-wp-scripts/ - **Structure minimale** : src/ et build/ selon les standards WordPress - **Build process** : npm run start (dev) / npm run build (prod) - **Assets** : Utiliser les .asset.php générés automatiquement ### Conventions obligatoires établies #### PHP - Préfixe fonctions : {plugin_name}_* - render.php : avec balise HTML directement - Enregistrement : register_block_type(__DIR__ . '/build') - Debug : error_log() pour traçabilité #### JavaScript/React - Hooks modernes uniquement - Attributes en camelCase - Classes CSS : .{plugin-name}-* - Debug : console.log() avec préfixes clairs #### Build Process - Toujours suivre la doc wp-scripts officielle - npm run build avant chaque test - Respecter la structure src/build générée ``` ### Section 6 : workflows opérationnels Cette section différencie les cas d’usage, propose des chemins optimisés et évite les erreurs de parcours. Technique utilisée : « [Conditional workflow prompting](https://learn.playlab.ai/prompting/advanced/conditional%20logic) » – une approche avancée de **prompt engineering**. ``` ## WORKFLOW OBLIGATOIRE ### Pour toute demande de NOUVEAU bloc : 1. **Question create-block** obligatoire 2. **Si create-block choisi** : Guide étape par étape de l'installation 3. **Si manuel** : Progression fichier par fichier 4. **Attendre validation** de l'utilisateur à chaque étape 5. **Proposer test** après chaque fichier important ### Pour modification de bloc existant : 1. **Identifier le fichier** à modifier 2. **Expliquer la modification** avant de la faire 3. **Donner UNE modification** à la fois 4. **Attendre confirmation** avant la suite ### Communication obligatoire : - **Toujours demander** : "Prêt pour l'étape suivante ?" - **Toujours expliquer** : "Voici ce qu'on va faire maintenant" - **Toujours tester** : "Peux-tu vérifier que ça fonctionne ?" - **Jamais supposer** : "As-tu des questions sur cette étape ?" ``` ### Section 7 : règles absolues Cette dernière couche renforce les points critiques, évite les dérives comportementales et garantit la cohérence d’exécution. Technique : « [Negative prompting](https://viso.ai/deep-learning/prompt-engineering/) » – une technique essentielle du **prompt engineering** moderne. ``` ## RÈGLES ABSOLUES - **JAMAIS** donner plus d'un fichier par réponse - **TOUJOURS** proposer create-block pour nouveaux blocs - **TOUJOURS** attendre confirmation avant de continuer - **TOUJOURS** expliquer le rôle de chaque fichier - **TOUJOURS** proposer un test après chaque étape - **JAMAIS** supposer que l'utilisateur suit sans problème Quand je demande une fonctionnalité, utilise OBLIGATOIREMENT cette approche progressive et patiente. ``` Techniques de prompt engineering utilisées ------------------------------------------ ### 1. Hiérarchisation visuelle Structure claire avec titres, sous-titres et micro-détails pour faciliter la lecture machine. Cette approche de hiérarchisation visuelle améliore significativement la compréhension de l’IA, avec des améliorations de performance allant de 2% à 63% selon les [recherches récentes](https://arxiv.org/html/2406.12644v3). ``` # Titre principal ## Sous-section ### Détail #### Micro-détail ``` ### 2. Emphase par formatage - **RÈGLE ABSOLUE** (gras + majuscules) - `code` (mise en évidence technique) - ✅ ❌ (symboles visuels) ### 3. Répétition stratégique Les points critiques du **prompt engineering** sont répétés pour renforcer l’apprentissage. ### 4. Structure conditionnelle Si X alors Y, Sinon Z – logique conditionnelle claire ### 5. Exemples concrets Chaque concept abstrait du **prompt engineering** doit être illustré Leçons pour maîtriser le prompt engineering ------------------------------------------- ### Principe 1 : architecture en entonnoir Le **prompt engineering** efficace commence large et finit précis. Cette approche guide progressivement l’IA vers le résultat souhaité. ### Principe 2 : répétition stratégique Les points critiques de votre **prompt engineering** doivent être martelés pour garantir la cohérence. ### Principe 3 : exemples concrets Chaque concept abstrait en **prompt engineering** doit être illustré par des exemples pratiques. ### Principe 4 : interdictions explicites Il faut dire ce qu’il ne faut PAS faire – principe fondamental du **prompt engineering**. ### Principe 5 : workflows conditionnels Prévoyez les différents cas d’usage dans votre approche de **prompt engineering**. Questions fréquentes sur le prompt engineering ---------------------------------------------- ### Qu'est-ce que le prompt engineering exactement ? Le prompt engineering est l'art de concevoir des instructions optimisées pour les modèles d'IA. Il s'agit de structurer vos demandes de manière à obtenir des résultats précis, cohérents et de qualité supérieure. ### Combien de temps faut-il pour maîtriser le prompt engineering ? En moyenne 3 à 6 mois de pratique régulière. Les bases s'acquièrent rapidement, mais la maîtrise avancée nécessite de l'expérience et de l'itération continue sur vos techniques. ### Quelles sont les erreurs courantes en prompt engineering ? Les 3 erreurs principales sont : instructions trop vagues, absence de contexte précis, et manque de contraintes techniques. Évitez ces pièges pour améliorer vos résultats. ### Le prompt engineering fonctionne-t-il avec tous les modèles d'IA ? Oui, mais avec des adaptations nécessaires. Chaque modèle (GPT-4, Claude, Gemini) a ses spécificités, mais les principes fondamentaux du prompt engineering restent universels. ### Comment mesurer l'efficacité de mes techniques de prompt engineering ? Utilisez des métriques qualitatives et quantitatives : cohérence des réponses, temps de génération, taux de satisfaction, et pertinence des résultats obtenus. Conclusion : le prompt engineering comme système ------------------------------------------------ Ton approche de **prompt engineering**, c’est pas juste une technique – c’est un véritable système qui : - Contraint l’IA dans un cadre précis - Guide l’utilisateur dans un parcours optimisé - Standardise la production de code - Évite les erreurs communes - Assure la cohérence des résultats Le **prompt engineering** bien maîtrisé devient ton meilleur allié pour obtenir des résultats constants et de qualité. À toi de jouer maintenant ! Commence par appliquer ces principes de **prompt engineering** dans tes prochains projets et observe la différence => et pour t’aider direction [mon article pour débuter avec l’IA dans son workflow](https://www.samy-kantari.fr/ia-workflow-developpement-guide-pratique/) ### 🚀 Téléchargez le prompt complet ! Gagnez du temps : récupérez mon prompt prêt à l’emploi. Importez-le et adaptez-le à vos besoins. [Télécharger le prompt (.md)](https://www.samy-kantari.fr/wp-content/uploads/2025/07/BLOCKCRAFT.md)