Une IA peut proposer une interface rapidement, mais elle ne connaît pas automatiquement le contrat de votre installation Phoenix. Si elle invente des champs, écrit les contenus dans les modèles ou recrée des réglages déjà disponibles, le résultat devient plus coûteux à raccorder.
Un bon prompt fournit donc les contraintes du projet aussi clairement que son intention visuelle.
Décrire le résultat attendu
Commencez par une page ou un composant précis. Indiquez le public, le message principal et l’action attendue. « Un bloc de présentation pour une communauté de créateurs WordPress » est un contexte ; ajoutez ce que cette présentation doit permettre de comprendre.
Précisez également le livrable : fichier Twig complet, feuille CSS locale, registre modifié ou simple proposition de structure. Une demande floue produit souvent un mélange de recommandations et de code difficile à installer.
La préparation du brief aide à distinguer les informations validées des décisions encore ouvertes.
Donner les vrais contrats techniques
Fournissez les noms des blocs et leurs champs. Pour about, indiquez les variables réellement exposées ; pour un bouton, expliquez le choix entre destination interne et externe. Si une fonction existe déjà, transmettez sa signature ou un exemple observé.
Contexte : design Phoenix dans designs/mon-design/.
Présentation Twig : parts/.
Fragments PHP : php/part/, via load_design().
Assets locaux : assets/styles.json.
Données : champs natifs des blocs, réglages Phoenix et menus WordPress.
Contraintes : ne pas créer de nouveau post type ni d’écran de réglages.
Ne pas modifier vendor/ pour une retouche de présentation.
Ajoutez un extrait du composant de référence et des valeurs de test. Les mots « utilise Phoenix » ne suffisent pas à faire deviner vos fonctions personnalisées.
Demander une séparation du contenu et du design
Les textes qui doivent être éditables viennent des champs, pas de chaînes écrites dans le Twig. Les menus se modifient dans WordPress. Les coordonnées et les boutons globaux suivent les réglages existants.
Demandez à l’IA de lister toute nouvelle variable proposée et sa source. Une variable sans champ ni transformation documentée est un point à résoudre avant l’intégration.
Exigez aussi un comportement pour les valeurs absentes : pas d’image, lien vide, liste vide et titre long. Ces situations sont normales dans un site administrable.
Encadrer les exemples et les affirmations
L’IA peut reformuler votre mission ou proposer une structure de texte. Elle ne doit pas inventer des clients, des témoignages, des chiffres de résultat ou une garantie de compatibilité.
Dans le prompt, distinguez les faits fournis et les éléments à confirmer. Demandez une formulation explicite lorsqu’une fonction dépend de la version du thème ou d’une extension.
N’envoyez pas un export de production complet pour obtenir une mise en page. Un extrait anonymisé des champs utiles suffit généralement. Les données de contacts et les secrets techniques n’aident pas à concevoir un hero.
Ajouter les critères de vérification au prompt
Une proposition de code devient plus utile lorsqu’elle prévoit sa recette :
- Le bloc fonctionne avec et sans média.
- Les boutons utilisent une URL échappée et un nom compréhensible.
- Le texte reste lisible sur téléphone et au clavier.
- Les CSS et JavaScript passent par le registre existant.
- Le rendu n’ajoute pas de données dans la base lors d’une simple visite.
Ces critères ne garantissent pas le résultat. Ils donnent une base de revue et empêchent certaines omissions prévisibles.
Relire avant d’intégrer
Examinez le diff proposé, les fichiers ajoutés et les dépendances. Essayez d’expliquer à une autre personne comment chaque valeur arrive dans le HTML. Si cette chaîne est floue, revenez à un composant plus petit.
Copiez ensuite l’exemple sur un environnement de développement et testez les contenus limites. La transformation d’une maquette IA décrit cette phase d’intégration.
L’IA donne un point de départ. Le raccordement aux vrais champs, la revue et les essais dans WordPress rendent ce travail exploitable dans Phoenix.
