Bien écrire ses demandes

L’agent de Highwind comprend le langage courant : tu n’as pas besoin de vocabulaire technique. Mais plus ta demande est précise, plus le résultat ressemble à ce que tu as en tête du premier coup, et moins tu dépenses de crédits en allers-retours. Cette page rassemble ce qui marche le mieux, avec des demandes à copier.

La recette d’une bonne première demande

La première demande pose les fondations : le type d’app, ses pages et son style. Pense à ces six points.

Quoi

Le type d’app : site vitrine, landing page, tableau de bord, outil de réservation, boutique, blog…

Pour qui

Le public visé : des clients d’un restaurant, une équipe interne, des étudiants. Le ton et le contenu en découlent.

Les pages ou sections

Accueil, tarifs, contact, page détail… ou les sections d’une page unique dans l’ordre.

Le contenu réel

Le nom, l’offre, les prix, les horaires, les coordonnées. Sans eux, l’agent invente un contenu réaliste.

Ce qu'on doit pouvoir faire

Réserver, filtrer, s’inscrire, recevoir un message par e-mail, se connecter à un compte…

Le style

Une ambiance (« sobre et éditorial », « coloré et ludique »), des couleurs, des polices, un site de référence.

Tu n’as pas besoin de tout préciser : ce que tu ne dis pas, l’agent le décide avec bon sens. Pour chaque nouvelle app, il part d’une direction artistique adaptée au sujet, mais tes indications de style passent toujours avant.

Comparaison :

Trop vague
Précis

Fais-moi un site pour ma boulangerie.

L’agent construira un site correct, mais avec un nom, des produits et des horaires inventés, et un style qu’il aura choisi seul.

Le site de « La Mie Dorée », boulangerie artisanale à Nantes (12 rue Crébillon).
Pour les gens du quartier qui veulent voir les produits et commander pour le week-end.
Sections : accueil avec une grande photo de pains, nos spécialités (pain au levain,
kouign-amann, fougasse), horaires (mardi-dimanche 7 h-19 h 30), commande en ligne
à retirer en boutique, avis clients, plan d'accès et contact.
Style chaleureux et artisanal, tons crème et brun doré, police avec empattement pour les titres.

Itérer : une modification à la fois

Une fois l’app construite, tu l’améliores par petites touches. Quelques règles simples :

Une demande, un changement. « Ajoute une page tarifs » puis « change la couleur principale » donnent de meilleurs résultats qu’une liste de dix changements dans un seul message. Une demande est d’ailleurs plafonnée à 12 crédits : l’agent s’arrête au-delà, en gardant le travail fait.
Dis où. « Dans la section témoignages », « sur la page Contact », « dans l’en-tête ». Mieux encore, désigne l’élément avec + → Sélectionner un élément (voir Sélectionner un élément).
Dis ce qui doit rester. « Garde la mise en page, change seulement les textes. »
Pour un bug, décris ce qui se passe. Ce que tu as fait, ce que tu attendais, ce qui s’est passé : « Quand je clique sur Réserver sans choisir de date, rien ne se passe. Il faudrait un message d’erreur sous le champ. »
Pour une erreur affichée dans l’aperçu, clique simplement sur Corriger dans le bandeau rouge : l’agent reçoit le détail de l’erreur.
Pour un texte, une couleur ou une police, pas besoin de demande : le mode Design te permet de le faire toi-même, gratuitement.

Exemples d’itérations :

Rends l'en-tête fixe en haut de la page quand on fait défiler.

Dans la grille des projets, ajoute des filtres par catégorie : Tous, Web, Print, Photo.

Le tableau des commandes doit pouvoir être trié par date et par montant.

Ajoute une page « Mentions légales » reliée depuis le pied de page.

Sur mobile, le menu doit se replier dans un bouton burger.

Ajoute un mode sombre, affiché selon le réglage de l'appareil.

Planifier avec le mode Discussion

Pour une grosse évolution ou quand tu hésites, passe en mode Discussion avant de construire : l’agent lit ton projet, répond à tes questions ou propose un plan numéroté, sans rien modifier.

Dans la zone de saisie, ouvre le sélecteur de mode et choisis Discussion (ou appuie sur Alt + P).
Pose ta question : « Comment ajouter un espace membre à mon site ? Quelles pages faudrait-il ? »
Ajuste le plan en discutant, puis clique sur Appliquer ce plan : l’agent repasse en construction et l’exécute.

Le mode Discussion marche aussi pour la toute première demande, depuis l’accueil : l’agent te pose ses questions et propose un plan avant de construire quoi que ce soit. Voir Mode Discussion.

Joindre des images

Une image vaut souvent mieux qu’une longue description. Ouvre le menu + de la zone de saisie, puis Joindre :

Option	À quoi ça sert
Image de référence	Une capture, une maquette ou une inspiration. L’agent la regarde, elle n’est pas ajoutée au site.
Envoyer une image dans le projet	Ton logo, tes photos : enregistrée dans le projet pour que l’agent la mette dans le site.
Utiliser une image du projet	Choisir parmi les images déjà envoyées dans le projet.
Image pour le site	Sur l’accueil, avant la création du projet : ajoutée au projet dès sa création.

Tu peux aussi coller une image ou la glisser dans la zone de saisie : elle est jointe comme image de référence. Jusqu’à 4 images par message.

Reproduis la mise en page de cette capture pour ma page d'accueil,
mais avec mes couleurs et mes textes.

Mets mon logo (image jointe) dans l'en-tête, à gauche, et dans le pied de page.

Mentionner un connecteur avec @

Pour brancher un service externe (e-mails, paiements, Google Sheets, IA…), tape @ dans la zone de saisie (ou ouvre + → Connecteurs), cherche le service et choisis-le. Une pastille s’insère dans ton message : l’agent sait alors exactement quel service utiliser.

Quand quelqu'un remplit le formulaire de contact, envoie-moi le message par e-mail avec @Resend.

Ajoute le paiement de la commande avec @Stripe.

Dans ces exemples, @Resend et @Stripe représentent la pastille insérée en tapant @ puis en choisissant le service dans la liste.

Si le service demande une clé, l’agent affiche une carte pour que tu l’ajoutes : ne colle jamais une clé dans le texte du chat. Voir Connecteurs.

Les sources de contexte se mentionnent de la même façon. Une fois ton compte connecté (page Connecteurs), l’agent peut lire ce que tu cites :

Construis l'app décrite dans ma page Notion « Spec appli de covoiturage ».

Reproduis cette frame Figma : https://www.figma.com/design/…

Voir Sources de contexte.

Donner des consignes permanentes au projet

Si tu te répètes (« toujours en vouvoiement », « pas de photos de stock »), écris-le une fois pour toutes dans Paramètres du projet → Général → Consignes pour l’agent (4 000 caractères au plus). L’agent les suit à chaque message de ce projet, à partir du message suivant.

Couleurs sobres : vert sapin et crème. Textes en vouvoiement, ton chaleureux mais professionnel.
Le site est en français. Pas d'emojis. Les prix sont toujours TTC.

Voir Paramètres du projet.

Quand l’agent te pose des questions

Si quelques réponses changent vraiment ce qu’il va construire et qu’il ne peut pas les deviner (nom de marque, couleurs ou logo, vraies offres et prix, coordonnées), l’agent affiche un formulaire Questions de l’agent au lieu d’une liste de questions en texte. Les champs sont déjà remplis avec ses suppositions : corrige ce qui ne va pas, envoie une image si on te la demande, puis Envoyer mes réponses. Si tu préfères qu’il décide, clique sur Laisser l’agent choisir. Il pose au plus un formulaire par demande, et seulement quand c’est utile.

Voir Questions de l’agent.

Des demandes à copier

Une landing page pour « Focus », une app mobile qui aide les étudiants à réviser
avec la méthode Pomodoro. Sections : héros avec une maquette de l'app, le problème
(la procrastination), trois fonctionnalités clés, comment ça marche en trois étapes,
témoignages d'étudiants, tarifs (gratuit et Premium à 3,99 €/mois), FAQ, appel final
avec boutons App Store et Google Play. Style graphique et énergique, orange vif sur fond crème.

Un outil de réservation pour mon salon de coiffure « Atelier Lou » à Bordeaux.
Les clients choisissent une prestation (coupe femme 45 €, coupe homme 25 €, couleur 70 €),
une coiffeuse (Lou ou Inès), puis un créneau libre dans un calendrier de la semaine
(mardi-samedi 9 h-19 h, créneaux de 30 min). Ils laissent nom et téléphone et voient un
récapitulatif. Je veux recevoir chaque réservation dans une feuille Google Sheets.

Une app de suivi de dépenses pour colocations. Chaque personne crée un compte avec e-mail
et mot de passe, crée une coloc ou en rejoint une avec un code, ajoute des dépenses
(montant, catégorie, qui a payé, pour qui) et voit qui doit combien à qui.
Pages : connexion, tableau de bord avec soldes et graphique par catégorie, liste des
dépenses filtrable, paramètres de la coloc. Style moderne et clair, accent vert menthe.

Un tableau de bord commercial pour une petite agence : barre latérale, quatre indicateurs
en haut (chiffre d'affaires du mois, nouveaux clients, devis en attente, taux de
conversion), courbe du chiffre d'affaires sur 12 mois, tableau des derniers devis avec
statut et filtre, et une page Clients avec recherche. Données d'exemple réalistes.
Thème sombre, sobre et technique.

Une page « bientôt disponible » pour ma marque de céramique « Terre & Feu » :
une grande photo, une phrase d'accroche, la date d'ouverture de la boutique (15 mars)
et un formulaire pour s'inscrire à la liste d'attente avec prénom et e-mail.
Enregistre les inscriptions dans Google Sheets.

Un outil qui résume un article de blog : on colle l'adresse d'une page, l'app récupère
le texte et affiche un résumé en 5 points et 3 idées de publications LinkedIn.
Utilise @Firecrawl pour lire la page et @OpenAI pour le résumé.

D’autres idées de départ :

« Un portfolio de photographe de mariage : galerie filtrable par lieu, page À propos, tarifs des formules et formulaire de demande de devis envoyé par e-mail. »
« La page de l’événement “Nantes Tech Day” le 12 juin : compte à rebours, programme heure par heure, intervenants avec photo et bio, plan d’accès et inscription. »
« Un calculateur de prêt immobilier : montant, durée, taux ; affiche la mensualité, le coût total et un tableau d’amortissement année par année. »
« Un quiz de 10 questions sur la cuisine italienne, avec score final, correction et bouton pour partager son résultat. »
« Un kanban pour suivre mes candidatures : colonnes À postuler, Envoyée, Entretien, Offre, Refus ; glisser-déposer, notes et date de relance sur chaque carte. »

Ce qu’il vaut mieux éviter

Les demandes floues : « rends-le plus beau », « améliore le site ». Dis ce qui ne va pas et dans quelle direction aller (« plus aéré, avec des titres plus grands et moins de couleurs »).
Dix changements dans un message : découpe en plusieurs demandes. Tu verras mieux chaque résultat, et tu restes sous le plafond de 12 crédits par demande.
Les consignes contradictoires : « minimaliste mais avec beaucoup d’animations et de couleurs ».
Coller une clé d’API ou un mot de passe dans le chat : utilise toujours la carte que l’agent affiche, ou Paramètres du projet → Secrets.
Des informations sensibles (données de santé, numéros de carte, données personnelles de tiers) : tes messages sont envoyés au fournisseur du modèle d’IA pour générer la réponse.
Répéter la même demande qui échoue : reviens à la version précédente, puis reformule autrement ou passe par le mode Discussion pour comprendre le problème.
Demander ce que Highwind ne fait pas encore : une app native pour l’App Store, un domaine personnalisé, un traitement qui tourne en continu sur un serveur.

Voir aussi

Le chatEnvoyer, arrêter, suggestions, retours.

Mode DiscussionPlanifier sans modifier l'app.

Comment travaille l'agentCe qu'il fait de ta demande, étape par étape.

Design et thèmesDirections artistiques, thème par rôles, polices.