Écrire un script Tuti Tuti

Ce document s’adresse à la personne, ou à l’IA, qui écrit la narration d’un tutoriel en français. Lisez-le en entier avant d’écrire. Tout ce qu’il contient est confronté à l’analyseur par des tests automatisés : il décrit ce que Tuti Tuti fait réellement, pas ce qu’il devrait faire. Quand l’analyseur ne prend pas quelque chose en charge, le guide le dit au lieu de le promettre. L’édition anglaise, docs/SCRIPT-GUIDE.md, suit la même numérotation ; les règles sont celles de l’analyseur, seuls les mots qui les déclenchent changent.

1. Ce que Tuti Tuti fait de vos mots

Tuti Tuti prend un script en texte brut et en fait un tutoriel qui se joue tout seul sur une application web en direct. Il lit chaque phrase et la classe dans l’une des trois catégories suivantes :

Catégorie	Sens	Ce qui se passe à l’écran
Agir (Act)	Le présentateur fait quelque chose	Un clic, une valeur tapée, un glissement ou une forme dessinée, sur un élément nommé
Montrer (Show)	Le présentateur pointe quelque chose	Un projecteur sur un élément nommé, sans y toucher
Dire (Say)	Le présentateur parle, sans plus	La page reste immobile

Il trouve ensuite chaque élément nommé sur la vraie page, exécute les gestes pendant qu’une voix lit les mots, et enregistre le résultat en vidéo. Il n’y a aucune couche cachée qui comprendrait une intention au-delà de ce qui est écrit. Si la phrase ne dit pas sur quoi cliquer, rien n’est cliqué.

Deux conséquences en découlent, et tout le reste du guide en dépend :

Chaque changement à l’écran a besoin de sa propre phrase, avec un verbe clair et le nom de la chose tel qu’il apparaît à l’écran.
Tout ce que vous écrivez est lu à voix haute. Écrivez comme parle un présentateur. Pas d’indications scéniques, pas de crochets, pas de puces.

2. Règles de l’oral

Le script est lu par une voix de synthèse et entendu par des gens qui ne regardent peut-être pas l’écran. Écrivez pour l’oreille.

Les acronymes s’écrivent comme ils se prononcent. « IA », « SMS », « API », « URL », « CSV » en majuscules, même si l’étiquette est présentée autrement à l’écran. La correspondance ignore la casse et les petites différences, alors c’est sans risque : les mots « AI Plan Maker » trouvent un bouton nommé « Ai Plan Maker » (vérifié par un test).

Mauvais :  Cliquez sur Planificateur Ia en haut à droite.     (la voix peut dire « ya »)
Bon :      Cliquez sur Planificateur IA en haut à droite.

Les nombres destinés à être entendus s’écrivent en lettres ou en chiffres espacés. « vingt-quatre heures », « 778 608 0369 ». Les nombres destinés à être tapés restent entre guillemets, exactement comme ils doivent être entrés ; la voix les lit, mais la saisie est exacte.

Mauvais :  Vous aurez une réponse en moins de 24 h.
Bon :      Vous aurez une réponse en moins de vingt-quatre heures.
Bon :      Par exemple, tapez « 2024-07-31 » dans le champ Date.     (tapé tel quel)

Aucun symbole que la voix lit mal dans la narration. Écrivez « et » plutôt que « & », « ou » plutôt que « / », « vingt-quatre heures sur vingt-quatre » plutôt que « 24/7 ». Au moment de la correspondance, « & » est lu comme « and », ce qui sert aux étiquettes anglaises : « Terms and Conditions » trouve encore un lien nommé « Terms & Conditions » (vérifié par un test). La seule exception est le texte entre guillemets, étiquettes et valeurs tapées, qui doit rester exactement tel qu’il apparaît ou tel qu’il doit être entré ; une étiquette française qui contient un symbole se met donc entre guillemets, telle quelle.

Mauvais :  Ouvrez Conditions & modalités et lisez la ligne de soutien 24/7.
Bon :      Ouvrez Conditions d'utilisation au bas de la page et lisez la ligne de soutien offerte vingt-quatre heures sur vingt-quatre.
Bon :      Tapez « A&B ltée » dans le champ Entreprise.     (tapé tel quel, y compris le &)

3. Narrer pour quelqu’un qui ne voit pas l’écran

Supposez que la personne entend la voix mais ne voit pas chaque pixel. Dites où sont les choses et ce qui apparaît.

Chaque chapitre s’ouvre sur une transition, puis sur le chemin exact. La transition est de la parole ordinaire ; le chemin, ce sont les clics. N’écrivez jamais seulement « Cliquez sur Messagerie vocale. » comme première phrase d’un chapitre.

Mauvais :  Cliquez sur Messagerie vocale.

Bon :      Maintenant, voyons la messagerie vocale. Ouvrez le menu. Cliquez sur Messagerie vocale dans le panneau de gauche.

« Maintenant, voyons … », « Ensuite, jetons un coup d’œil à … », « Parlons de … », « Passons à … », « Regardons … », « Découvrons … » sont des phrases Dire : elles ne cliquent ni ne pointent jamais rien (vérifié par un test). Ce sont les phrases qui suivent qui font le travail. En anglais, la transition type est « Now let’s take a look at … ».

Chaque bouton reçoit une indication de lieu. « Cliquez sur Ajouter un contact en haut à droite. » « Cliquez sur Créateur d’horaire dans le coin inférieur droit. » « Cliquez sur Messagerie vocale dans le panneau de gauche. » L’indication est pour l’auditeur ; l’analyseur coupe la cible juste avant. Les mots qui terminent une cible : à, au, aux, en, dans, sous, sur, pour, afin de, avec, par, puis, après, avant, depuis, vers, près de, à côté de, au-dessus, en dessous, qui, que, où, et, ou, parce que, si, quand, lorsque, pendant, une fois, en utilisant, ainsi que les virgules, points-virgules, deux-points et tirets, et les mots anglais équivalents (at, in, from, with, to, and, or et les autres). Une mise en garde : par, avec, en utilisant, grâce à, comme suivis d’une énumération séparée par des virgules sont lus comme une liste d’éléments à éclairer tour à tour, comme dans « vous pouvez ajouter des articles par photo, voix ou saisie ».

Mauvais :  Cliquez sur Ajouter un contact.
Bon :      Cliquez sur Ajouter un contact en haut à droite de la liste.

La première valeur tapée dans un formulaire est introduite par « Par exemple, … » ; les champs suivants du même formulaire s’en passent. La règle de saisie accepte les deux formes (vérifié par un test).

Par exemple, tapez « Jeanne Hamilton » dans le champ Nom.
Tapez « 778 608 0369 » dans le champ Téléphone.

Dites ce que la personne devrait maintenant voir après chaque geste. Une phrase Montrer juste après un clic confirme à l’auditeur que le clic a fonctionné et laisse à la page le temps de se mettre à jour.

Cliquez sur Ajouter un contact en haut à droite. Ici, vous voyez le formulaire du nouveau contact avec les champs du nom et du téléphone.

4. La forme d’un script

Texte brut. Une phrase par temps de narration. Un geste par phrase.
Une ligne vide commence un nouveau chapitre. Les chapitres sont les unités que l’on joue et que l’on exporte séparément : un chapitre par page ou par fonction.
Une courte ligne de titre facultative, juste avant le paragraphe d’un chapitre, le nomme. Elle n’est pas lue. Sept mots ou moins, sans point final. Les formes # Titre et 1:47 Titre fonctionnent aussi.
Écrivez les phrases dans l’ordre exact où l’écran change.
Les phrases se terminent par un point, un point d’interrogation ou un point d’exclamation. Une phrase qui commence par une minuscule est quand même détachée de la précédente.
Une citation n’est jamais coupée, peu importe le nombre de points qu’elle contient. « Vous pouvez taper ici : « Nous sommes à Montréal. Nous ouvrons à neuf heures. Laissez un message et nous vous rappellerons. » » est une seule phrase, et tout le message est tapé exactement comme il est écrit (vérifié par un test). Utilisez les guillemets français « » avec une espace à l’intérieur, ou les guillemets droits "…", pour tout ce qui est tapé ; les apostrophes à l’intérieur ne posent aucun problème.

Entrepôts
Maintenant, jetons un coup d'œil à la carte de l'entrepôt. Cliquez sur Carte de l'entrepôt dans le menu de gauche. Ici, vous voyez chaque allée et chaque étagère, disposées comme dans votre espace réel. Cliquez sur Nouvel entrepôt en haut de la carte. Par exemple, tapez « Rez-de-chaussée » dans le champ Nom. Ensuite, cliquez sur Créer au bas du formulaire.

5. Les phrases Agir

Une phrase Agir commence par, ou contient, un verbe reconnu suivi du nom de la chose tel qu’il apparaît à l’écran.

5.1 Cliquer

Verbes reconnus : cliquez (sur), appuyez (sur), touchez, sélectionnez, choisissez, ouvrez, dépliez, repliez, basculez, lancez, soumettez, validez, fermez. Aussi allez à, allez dans, rendez-vous à, passez à, retournez à, revenez à, naviguez vers, accédez à, ainsi que activez, désactivez, cochez, décochez, et survolez ou passez la souris sur. En anglais : click, open, go to, switch to, turn on, hover over et les autres de l’édition anglaise.

Cliquez sur Nouvel entrepôt en haut de la carte.
Maintenant, allez dans Achats.
Passez à Carte de l'entrepôt dans le menu de gauche.
Ouvrez l'onglet Fournisseurs en haut de la liste.
Activez le mode sombre.

Certains mots sont à la fois le verbe et le bouton : connectez-vous, se connecter, connexion, inscrivez-vous, inscription, déconnectez-vous, déconnexion, enregistrez, annulez, continuez, suivant, retour, fermez, terminez, actualisez, validez, et leurs infinitifs. Employez-les seuls dans leur phrase, ou juste après puis, maintenant, ensuite, allons, on va, vous pouvez, sans virgule entre les deux. « Enregistrez. » et « Puis enregistrez. » appuient sur Enregistrer, parce que l’analyseur cherche l’infinitif, qui est ce qu’affichent les boutons français ; « Ensuite, enregistrez. », avec sa virgule, est une phrase Dire. « Connectez-vous. » est lu comme un clic sur ce mot-là ; si le bouton dit « Se connecter », nommez-le : l’étiquette exacte l’emporte toujours. Les mots suivant, retour, continuer, fermer, terminer ne comptent comme clic que s’ils forment la phrase à eux seuls : « Ensuite, voyons la facturation. » est une transition, pas un appui sur un bouton Suivant (vérifié par un test).

Connectez-vous.
Puis enregistrez.
Suivant.

Les verbes de confirmation cliquent sur le bouton qui porte le verbe. Créez, ajoutez, enregistrez, soumettez, confirmez, terminez, appliquez, envoyez, publiez, mettez à jour, supprimez, retirez, générez, démarrez, importez, exportez, invitez, connectez, téléversez, téléchargez, imprimez, suivis de ce qui est confirmé. Tuti Tuti cherche « Envoyer le message » d’abord, puis un bouton qui dit simplement « Envoyer » ; il essaie l’infinitif (Créer, Envoyer) parce que c’est ce qu’affichent les boutons français (vérifié par un test).

Ensuite, créez votre entrepôt.
Puis envoyez le message.

Employez-les uniquement comme consignes, en début de phrase ou après puis, ensuite, maintenant, d’abord, enfin, après cela, allons, on va, nous allons. « Vous pouvez ajouter des articles par photo » est une capacité, et devient une phrase Montrer (voir la section 6).

5.2 Taper

Mettez la valeur entre guillemets. Nommez le champ après dans ou sur. Introduisez la première valeur d’un formulaire par « Par exemple, » pour que l’auditeur sache qu’il s’agit d’un exemple ; les champs suivants du même formulaire s’en passent. Verbes reconnus : tapez, saisissez, entrez, écrivez, inscrivez, collez, indiquez, renseignez, recherchez (en anglais : type, enter, write, paste).

Par exemple, tapez « Widget bleu » dans le champ Recherche.
Par exemple, saisissez « 42 » dans le champ Quantité.
Nommez-le « Entrepôt principal ».

La troisième forme écrit dans le champ nommé Nom ; Appelez-le, Intitulez-le et Donnez-lui le nom font la même chose. Un simple « Tapez « Rez-de-chaussée ». » sans champ nommé écrit dans le champ qui attend une saisie : celui qui a déjà le focus, ou le seul champ de la boîte de dialogue qui vient de s’ouvrir.

Un champ par phrase. Un formulaire de trois champs, c’est trois phrases, puis une quatrième pour le bouton de validation.

Plusieurs champs à la suite, sans nommer chacun. Après une phrase de saisie, un simple « écrivez … » passe au prochain champ vide du même formulaire ; une phrase qui offre un autre exemple pour le même champ, ouverte par ou, sinon, autrement ou plutôt, réécrit le même champ au lieu d’avancer. Nommer le champ avant le verbe fonctionne aussi : « Pour le numéro de téléphone, écrivez « 778 608 0369 ». » trouve le champ du téléphone, et un champ sans étiquette est quand même trouvé par son type (vérifié par des tests).

Par exemple, écrivez « Jordan Lee ».                       (premier champ)
Ou vous pouvez écrire « Pandacat ».                        (même champ, réécrit)
Pour le numéro de téléphone, écrivez « 778 608 0369 ».     (le champ du téléphone)

5.3 Dessiner (cliquer, maintenir, glisser, relâcher)

Pour les applications où l’on dessine des formes sur un plan ou un canevas. Formules reconnues : cliquez et faites glisser, cliquez et maintenez, cliquez et glissez, appuyez et faites glisser, faites glisser votre curseur, dessinez, tracez, esquissez, délimitez, et cliquez n’importe où dans X … et faites glisser / relâchez.

Cliquez et faites glisser sur le plan pour dessiner la forme de l'entrepôt.
Cliquez n'importe où dans la boîte de l'entrepôt et faites glisser votre curseur, puis relâchez.
Dessinez un grand rectangle pour la première allée.

Nommez la surface après sur, dans ou à l’intérieur de. Si aucune n’est nommée, Tuti Tuti prend le plus grand canevas ou plan à l’écran. La taille de la boîte vient des mots qui disent ce qui est dessiné, et ces mots sont anglais pour le moment : aisle est long et mince, shelf est petit, zone est un bloc, warehouse est grand, et small, large, whole changent l’échelle. Une phrase française obtient un bloc moyen au centre de la surface ; si la forme compte, dites-le au propriétaire de l’application plutôt que de mélanger les langues. Si un mode de dessin doit être choisi d’abord, dites-le dans sa propre phrase avant la phrase de dessin.

5.4 Glisser une chose sur une autre

Glissez le Widget bleu sur l'étagère A.
Déplacez la zone Réception dans l'allée 2.

5.5 Deux gestes dans une phrase

« X, puis Y » est séparé en deux temps automatiquement quand les deux moitiés sont des gestes ; et ensuite, ensuite et après cela font de même. « Nommez-le « Allée 1 », puis sélectionnez la forme. » devient deux phrases (vérifié par un test). Toute autre phrase jointe par et n’exécute que le premier geste. Dans le doute, écrivez deux phrases. En anglais, la charnière est « and then ».

6. Les phrases Montrer

Une phrase Montrer nomme quelque chose sans agir dessus. Ouvertures reconnues :

Ici, vous voyez le …, vous verrez le …, vous trouverez le …, remarquez le …, regardez le …, observez le …, repérez le …, notez le …
Voici le …, voilà le …, c’est le …, ce sont les …, il y a un …
Le X est ici, le X se trouve en haut à gauche, le X apparaît ici, le X s’affiche à droite
Vous pouvez …, vous pourrez …, il est possible de …, cela vous permet de … (une capacité, pointée, pas exécutée)

En anglais : here you’ll see, notice, here’s, this is, the X lives here, you can.

Ici, vous voyez le journal d'activité.
Voici l'assistant IA.
Les bons de commande se trouvent ici.
Vous pouvez ajouter des articles par photo, voix ou saisie.

La dernière forme est particulière : une énumération après par, avec, en utilisant ou grâce à éclaire chaque élément au moment où son mot est prononcé.

Les deux premiers groupes d’ouvertures ne comptent que si une chose nommée suit : le, la, les, votre, chaque, tous les, un nom avec sa majuscule, ou une étiquette entre guillemets. « Tout ce que vous verrez fonctionne avec le forfait gratuit » ne nomme rien après vous verrez, alors c’est une phrase Dire. Une quantité n’est pas une chose non plus : « Il y a deux modes. » est une phrase Dire. Et « voyons », « jetons un coup d’œil à » sont des transitions (section 3), jamais des phrases Montrer.

7. Les phrases Dire

Tout le reste. Les vues d’ensemble, les avantages, les raisons, les transitions, ce que la personne obtiendra. La page reste immobile et les mots sont prononcés, avec sous-titres.

Gardez les verbes d’action hors des phrases Dire. « Dans cette vidéo, vous allez dans les paramètres » essaierait de cliquer sur « paramètres ». Décrivez avec nous verrons comment, cette vidéo couvre, l’application comporte, il y a, l’application conserve. Notez que vous verrez le tableau de bord est une phrase Montrer, parce qu’elle nomme une chose ; vous verrez comment les pièces s’articulent est une phrase Dire, parce qu’elle n’en nomme aucune.

8. Nommer la chose : la compétence la plus importante

La cible, ce sont les mots juste après le verbe. Tuti Tuti les compare à ce qui est visible : texte des boutons, texte des liens, étiquettes, textes indicatifs, noms des icônes. Les mots exacts gagnent toujours. Quelques synonymes sont compris, mais ce sont des synonymes anglais (home / dashboard, sign in / log in, bell / notifications, settings / preferences, add / new / create, menu / hamburger / sidebar) ; une étiquette française est trouvée par ses propres mots, alors employez-les.

Par ordre de fiabilité :

L’étiquette exacte, entre guillemets ou avec ses majuscules. Cliquez sur « Nouvel entrepôt » en haut à droite. Ouvrez Bons de commande dans le menu de gauche.
L’étiquette en mots ordinaires. allez dans achats trouve Achats.
Avec un mot de rôle, devant le nom, en minuscules. l'onglet Fournisseurs, l'icône de cloche, le champ Recherche, le bouton Enregistrer. Le mot de rôle est retiré de la recherche et sert à privilégier le bon type d’élément ; le de qui le suit tombe aussi (« l’icône de cloche » cherche « cloche »).

Règles :

Six mots ou moins.
Jamais un pronom ni un mot de lieu : ni le, la, les, ceci, cela, ça, ici, là, n’importe où, quelque part.
Employez les mots qui sont à l’écran, pas une description de la fonction. « le bouton qui ouvre le formulaire de commande » échoue ; « Nouvelle commande » réussit.
Écrivez l’étiquette avec sa majuscule, comme à l’écran. Un mot de rôle en minuscules devant un nom est retiré : « Passez à la carte de l’entrepôt. » cherche une carte nommée « entrepôt », tandis que « Passez à Carte de l’entrepôt dans le menu de gauche. » cherche « Carte de l’entrepôt », qui est l’étiquette.
Une étiquette qui contient et ou ou se met entre guillemets ; sinon, le mot coupe la cible. « Ouvrez « Termes et conditions » au bas de la page. »
Un mot entre guillemets n’est jamais lu comme une commande. Sélectionnez « ajouter ou dessiner une allée » dans la barre du haut. est un clic sur cette étiquette, même si elle contient « dessiner ».
Si vous ne connaissez pas l’étiquette exacte, employez la plus courte qui soit plausible. La correspondance approximative couvre les petites différences et la casse, pas les paraphrases.

La place de la cible dans la phrase décide du moment du clic. Le clic tombe sur le mot le plus long de la cible, à l’intérieur de l’expression, de sorte qu’un mot déjà prononcé plus tôt dans la phrase ne déclenche rien avant l’heure. Placez la cible tôt et laissez le lieu et la raison suivre.

9. Les habitudes de navigation

Les menus coulissants et les listes déroulantes derrière un avatar. Le lien de la page n’est pas à l’écran tant que le menu n’est pas ouvert, alors « Ouvrez le menu. » forme sa propre phrase avant chaque clic de page. Répétez-la dans chaque chapitre, parce que les chapitres se jouent et s’exportent séparément et que chacun part de l’état où se trouve l’application.

Mauvais :  Cliquez sur Messagerie vocale dans le panneau de gauche.                     (le panneau est fermé)

Bon :      Ouvrez le menu. Cliquez sur Messagerie vocale dans le panneau de gauche.

Les boutons sans texte. Tuti Tuti lit l’étiquette d’accessibilité d’un bouton et son infobulle en plus du texte visible, dans cet ordre. Un menu hamburger sans texte mais étiqueté « Ouvrir le menu » répond donc à « menu ». Une icône seule, sans étiquette ni infobulle, n’a que sa couleur et sa position, comme dans « l’icône dorée sur le bord gauche », ce qui reste fragile. Demandez une étiquette au propriétaire de l’application plutôt que de deviner.

Menus, boîtes de dialogue, onglets, modes, données. Ouvrez le menu dans une phrase, choisissez l’élément dans la suivante. Ouvrir une boîte de dialogue est une phrase, chaque champ est une phrase, le bouton de confirmation est une phrase, la fermeture est une phrase. Nommez l’onglet. Cliquez sur un mode de dessin ou d’édition avant de l’utiliser. N’agissez que sur des données qui existent. Le défilement est automatique ; n’écrivez pas « faites défiler jusqu’à ». Les raccourcis clavier ne sont pas pris en charge ; « Appuyez sur Entrée » serait lu comme un clic sur quelque chose nommé Entrée, alors écrivez le clic.

10. Les écrans avec une IA en direct

Quand une étape s’adresse à un robot conversationnel, à un assistant ou à tout ce qui répond à son propre rythme :

Mettez tout ce dont l’assistant a besoin dans un seul message tapé. Le script ne sait pas répondre à une question de relance. Si l’assistant en pose une, le prochain clic manquera sa cible, parce que l’écran ne sera pas celui que le script attend.
Faites suivre chaque envoi de deux ou trois phrases de narration pour que la réponse ait le temps d’arriver avant le prochain geste.
Dites quoi faire si l’assistant pose quand même une question. C’est une note pour la personne qui lit le script, écrite comme une phrase Dire.

Par exemple, tapez « Prépare un horaire hebdomadaire pour une équipe de ménage de deux personnes qui couvre six maisons » dans la boîte de message. Puis envoyez le message. L'assistant lit la demande et rédige l'horaire. Cela prend habituellement quelques secondes. Ici, vous voyez la fiche de proposition avec la semaine détaillée. Si l'assistant pose plutôt une question, répondez-lui dans la boîte, envoyez de nouveau, et l'horaire apparaît.

Tuti Tuti ne sait pas attendre une réponse par lui-même : c’est la narration qui tient lieu d’attente.

11. Les effets sur les données

Le script tourne sur une application en direct. Chaque phrase Agir touche à de vraies données. Avant d’écrire :

Faites la liste de ce que la visite crée : fiches, contacts, horaires, messages, entrepôts. Joignez cette liste au script.
Dites comment nettoyer entre deux prises, sinon la deuxième lecture trouvera la chose déjà là et l’histoire ne correspondra plus à l’écran.
Employez les valeurs de démonstration désignées par le propriétaire de l’application. Pour les contacts et les textos, cela veut dire un vrai numéro d’entreprise choisi pour les démonstrations, jamais le numéro d’un inconnu, qui pourrait être facturé ou bloqué. Même chose pour les courriels.

12. Écrire la visite complète d’une application

Un chapitre par page ou par fonction, dans l’ordre où quelqu’un qui débute les découvrirait. Un chapitre qui fonctionne :

Transition. Une phrase Dire : « Maintenant, jetons un coup d’œil aux achats. »
Chemin. Les phrases Agir qui y mènent, avec les lieux : « Ouvrez le menu. Cliquez sur Achats dans le panneau de gauche. »
Repère. Une phrase Montrer : « Ici, vous voyez tous les bons de commande, regroupés par fournisseur. »
Explication. Une ou deux phrases Dire sur ce qui compte.
Démonstration. Une à trois phrases Agir qui font la chose la plus utile de cette page, chacune avec l’étiquette exacte et un lieu.
Confirmation. Une phrase Montrer qui dit ce qui est apparu.

Deux à huit phrases par chapitre. Huit à dix-huit mots par phrase. Le rythme parlé est d’environ deux mots et demi par seconde. Ouvrez par un chapitre Introduction de deux ou trois phrases Dire, sans geste. Fermez par un court chapitre Dire. Variez les ouvertures. Parlez comme une personne qui montre quelque chose à une collègue. Ne décrivez jamais les mouvements du curseur.

Avant d’écrire, il vous faut

Les pages ou les fonctions, dans l’ordre, avec les étiquettes de navigation exactes et la façon dont la navigation s’ouvre.
Les étiquettes exactes des boutons, onglets et champs que vous utiliserez, et à peu près où ils se trouvent.
Les valeurs de démonstration du propriétaire pour tout ce qui est tapé.

Si vous n’avez pas les étiquettes exactes, demandez-les. Deviner les étiquettes est la première cause d’échec d’un script.

13. Autovérification avant de remettre le script

Chaque changement à l’écran a sa propre phrase, avec un verbe reconnu et le nom affiché à l’écran.
Chaque chapitre s’ouvre sur une transition, puis « Ouvrez le menu. » si l’application l’exige, puis les clics.
Chaque bouton a une indication de lieu. La première valeur tapée de chaque formulaire commence par « Par exemple, » ; chaque valeur tapée est entre guillemets.
Les acronymes sont en majuscules, comme ils se prononcent ; les nombres entendus sont en lettres ou en chiffres espacés ; aucun & ni / dans la narration.
Rien n’est cliqué avant d’être visible. Les menus, boîtes de dialogue et modes sont ouverts d’abord.
Aucun le, la, ceci, cela, ici, là, n’importe où comme cible.
Les phrases Dire ne contiennent aucun verbe d’action.
Les étapes avec une IA en direct emploient un seul message complet, puis deux ou trois phrases de narration.
La liste de ce que la visite crée, et le nettoyage, accompagnent le script.
Des lignes vides entre les chapitres, chacun avec une courte ligne de titre non lue. Pas de crochets, de puces, d’émojis ni de Markdown.
Lu à voix haute, le texte sonne comme une vraie personne qui parle.

14. Format de sortie

Remettez du texte brut, rien d’autre. La ligne de titre du chapitre, un retour à la ligne, les phrases du chapitre en un seul paragraphe, une ligne vide, le chapitre suivant. Aucune autre mise en forme, d’aucune sorte.

15. La consigne à donner à une IA

Il existe trois types de script, et la première chose qu’une IA doit établir est celui qu’on veut : une démo de produit (environ soixante secondes, ou environ trois minutes : le seul résultat qui compte pour un acheteur, sans les réglages), un tutoriel pas à pas (une tâche du début à la fin, ou une fonction de bout en bout : chaque clic et chaque valeur tapée dans l’ordre, chaque résultat confirmé), ou une visite détaillée (un écran, ou toute l’application : chaque commande nommée par son libellé exact et expliquée, rien d’oublié, pas même un petit bouton). Demandez si la personne ne l’a pas dit. Les consignes toutes prêtes pour chacun se trouvent sur tutituti.ca et parmi les invites du serveur MCP. La consigne ci-dessous s’applique ensuite aux trois.

Tu écris la narration d’un tutoriel Tuti Tuti, qui sera lue à voix haute par une voix de synthèse, jouée sur l’application en direct et entendue par des gens qui ne voient pas l’écran. Écris en prose simple, en français, une phrase par temps de narration, un geste par phrase.

Règles de l’oral : écris les acronymes comme ils se prononcent, en majuscules (« IA », « SMS », « API »), même si l’étiquette à l’écran est stylée autrement ; écris les nombres destinés à être entendus en lettres ou en chiffres espacés (« vingt-quatre heures », « 778 608 0369 »), et garde les nombres destinés à être tapés entre guillemets, exactement comme ils doivent être entrés ; n’emploie aucun symbole que la voix lit mal dans la narration (« et » plutôt que « & », « ou » plutôt que « / », « vingt-quatre heures sur vingt-quatre » plutôt que « 24/7 »), sauf dans les étiquettes entre guillemets et les valeurs tapées, qui restent exactes.

Pour un auditeur qui ne voit pas l’écran : ouvre chaque chapitre par une transition (« Maintenant, voyons la messagerie vocale. »), puis le chemin exact (« Ouvrez le menu. Cliquez sur Messagerie vocale dans le panneau de gauche. »), jamais seulement « Cliquez sur Messagerie vocale » ; donne à chaque bouton une indication de lieu (« Cliquez sur Ajouter un contact en haut à droite ») ; introduis la première valeur tapée d’un formulaire par « Par exemple, tapez « … » dans le champ Nom. » et tape les autres champs du formulaire sans répéter « Par exemple » ; et après chaque geste, dis ce que la personne voit maintenant (« Ici, vous voyez la fiche de proposition … »).

Chaque fois que l’écran doit changer, écris une phrase qui emploie un verbe d’action (cliquez sur, ouvrez, allez dans, passez à, sélectionnez, tapez … dans …, cliquez et faites glisser sur …) suivi de l’étiquette exacte affichée à l’écran, entre guillemets ou avec ses majuscules. Ouvre les menus, les boîtes de dialogue et les modes dans leur propre phrase avant de parler de ce qu’ils révèlent, dans chaque chapitre. Garde les vues d’ensemble libres de verbes d’action. Pour une étape avec un robot conversationnel, mets tout dans un seul message tapé, puis deux ou trois phrases de narration. Fais la liste de ce que la visite crée et de la façon de nettoyer. Mets une ligne vide entre les fonctions, avec une courte ligne de titre non lue avant chacune. Pas de crochets, de puces ni d’indications scéniques. N’emploie que les étiquettes qu’on t’a données ; demande celles qui manquent.

16. Après la répétition : le fichier de reprise

La répétition est l’épreuve d’un script. Quand elle est terminée, l’étape 05 Rework du panneau produit un fichier JSON (Titre - rework.json) écrit pour la personne ou l’IA qui réécrira le script, le plus souvent l’IA qui construit l’application. Il liste chaque phrase avec un état et, pour tout ce qui n’a pas donné une correspondance nette, un constat, un scriptFix et un appFix :

état	ce qui s’est passé	quoi faire
`ok`	les mots ont trouvé un seul élément	laisser la phrase telle quelle
`asked`	plusieurs éléments correspondaient ; une personne ou un modèle en a choisi un	employer l’étiquette `pinnedTo` et ajouter un lieu ou un mot de rôle
`pointed`	rien ne correspondait ; le propriétaire a cliqué sur l’élément	dire l’étiquette `pinnedTo`, qui est ce qu’il voulait dire
`recorded`	le propriétaire l’a fait à la main, en plusieurs gestes	une phrase par changement d’écran, chacune avec l’étiquette de son contrôle
`skipped`	le propriétaire a sauté la phrase ; elle ne fait plus que parler	si un changement d’écran était voulu, nommer son contrôle
`missing`	rien sur la page ne correspondait ; c’est maintenant de la narration	étiquette exacte, indication de lieu, et ouvrir d’abord ce qui la révèle
`failed`	épinglée, mais quelque chose a mal tourné pendant la lecture	lire le constat ; souvent l’application a besoin d’un correctif de disponibilité (section 9 du guide de l’application)

Le fichier contient aussi le script complet tel qu’il est, pour que la réécriture puisse être recollée directement dans Tuti Tuti et répétée de nouveau. Donnez-le à l’IA avec une seule ligne : « Réécris ce script en suivant docs/SCRIPT-GUIDE.fr.md ; les consignes dans le fichier disent comment le lire. »

17. Un exemple complet

Voir l’exemple de la visite rapide. La suite de tests l’analyse phrase par phrase, et chacune en ressort avec la catégorie et le geste décrits dans ce guide. docs/examples/quick-tour.txt est la même visite en anglais.

18. Écrire en anglais

Les mêmes règles, en anglais. L’analyseur lit les deux langues phrase par phrase, alors un script anglais n’exige aucun réglage, et une voix en-CA ou en-US le lit. L’édition anglaise de ce guide, docs/SCRIPT-GUIDE.md, donne tous les détails ; en bref :

Transitions : « Now let’s take a look at … », « Next, let’s look at … », « Let’s talk about … », « Let’s walk through … ».
Cliquer : click (on), tap, press, select, choose, open, go to, switch to, turn on, turn off, check, uncheck, et hover over. Lieux : « at the top right », « in the left menu », « at the bottom of the page ». La cible s’arrête à at, in, from, with, to, and, or et aux autres mots de la section 3.
Le mot de rôle vient après le nom : « the Save button », « the Suppliers tab », « the bell icon », « the Search box ».
Taper : type, enter, write, paste, la valeur entre guillemets droits, le champ après into ou in. « For example, type "Main Warehouse" into the Name field. » « For the phone number, write "778 608 0369". » « Name it "Aisle 1". » « Or you can write "Pandacat". » réécrit le même champ. « For example, » ouvre la première valeur d’un formulaire seulement, comme en français.
Confirmer : « Then create your warehouse. » appuie sur le bouton qui porte le verbe ; « Let’s sign in. » et « Then save. » appuient sur Sign in et Save.
Montrer : « Here you’ll see the dashboard. » « This is the AI assistant. » « You can add items by photo, voice, or typing. » « The purchase orders live here. »
Dessiner et glisser : « Click and drag on the floor plan to draw the shape. » « Click anywhere inside the warehouse box and drag your cursor, then let go. » « Drag the Blue widget onto Shelf A. » Les mots de taille (aisle, shelf, zone, warehouse, small, large, whole) sont lus en anglais.
Deux gestes : « and then » sépare une phrase en deux temps quand les deux moitiés agissent.
Les étiquettes restent exactement comme l’application les affiche, dans la langue que parle l’application.

docs/examples/quick-tour.txt est la visite rapide en anglais. La suite de tests l’analyse phrase par phrase, comme la française.