2. Rédiger un brief efficace

Code Builder transforme une description en langage naturel en une application fonctionnelle. Vous rédigez un brief, l'IA génère le code, l'exécute dans un bac à sable cloud isolé, et affiche un aperçu en direct juste à côté de votre conversation. La qualité de cette première version générée dépend presque entièrement de la qualité de votre brief. Un prompt vague produit un squelette générique que vous passerez de nombreuses itérations à corriger ; un brief bien structuré vous permet d'atteindre 80 % du résultat dès la première tentative. Votre brief doit couvrir trois piliers : l'objectif (ce que fait l'application et pour qui), les écrans (les vues ou pages distinctes et leur mise en page), et les comportements clés (interactions, flux de données, règles métier). Bien maîtriser ces trois piliers minimise les crédits IA et le temps d'exécution du bac à sable gaspillés, car chaque itération supplémentaire a un coût sur les deux plans.

Pilier 1 — Objectif. Commencez par une seule phrase indiquant ce qu'est l'application et à qui elle s'adresse. Cela oriente chaque décision que l'IA prendra par la suite. Mauvais exemple : « Créez-moi un tableau de bord. » Bon exemple : « Créez un tableau de bord IoT en temps réel pour les gestionnaires d'installations qui surveillent des capteurs de température et d'humidité dans plusieurs bâtiments. » Incluez le domaine, le rôle principal de l'utilisateur et la proposition de valeur essentielle. S'il existe plusieurs rôles d'utilisateurs (par exemple, administrateur vs. lecteur), listez-les ainsi que leurs autorisations. Le bloc objectif fait office de contrat : l'IA s'y référera lors de la génération de la navigation, des modèles de données et du contrôle d'accès.

Pilier 2 — Écrans. Énumérez chaque vue distincte. Pour chaque écran, précisez : son nom, les données qu'il affiche ou collecte, et sa mise en page générale (barre latérale + panneau principal, tableau pleine largeur, grille de cartes, etc.). Classez les écrans selon le parcours utilisateur — l'IA utilise cet ordre pour connecter la navigation. Exemple :

1. Connexion — formulaire e-mail/mot de passe, redirection vers le Tableau de bord en cas de succès.
2. Tableau de bord — grille de cartes de bâtiments affichant les dernières lectures de capteurs ; cliquer sur une carte → Détail du bâtiment.
3. Détail du bâtiment — graphiques linéaires de température et d'humidité sur les dernières 24 h, liste des alertes.
4. Paramètres — gérer les seuils de capteurs déclenchant les alertes.

Ce niveau de précision permet à l'IA d'échafauder les bonnes routes et les bons composants dès la première tentative.

Pilier 3 — Comportements clés. Les comportements sont les règles dynamiques qui font que l'application dépasse le stade de simples pages statiques. Décrivez les interactions (« cliquer sur une ligne ouvre une fenêtre modale d'édition »), les validations (« le champ e-mail doit être unique »), les mises à jour en temps réel (« les nouvelles données de capteur apparaissent sans rechargement de la page ») et les cas limites (« afficher une illustration d'état vide lorsqu'aucun capteur n'est configuré »). Utilisez un langage impératif que l'IA peut traduire directement en code : « Lorsque l'utilisateur soumet le formulaire, valider tous les champs et afficher les erreurs en ligne avant l'enregistrement. » Chaque comportement que vous omettez est un comportement que vous devrez ajouter plus tard via une conversation itérative — un changement à la fois — ce qui engendre des crédits supplémentaires.