Le plan

Ce que vous voyez

Comment nous avons construit une IA qui connaît notre entreprise est l’un des plus longs guides de ce site: comment nous avons donné à l’IA de Carewell une mémoire partagée et durable de l’entreprise, et comment construire la même chose. Le voici en document Word de 26 pages, en anglais. Le texte est celui du guide, inchangé. Tout ce qui l’entoure est nouveau: une couverture, une table des matières, un résumé sur une page, un chapitre par section avec son nom en haut de chaque page, huit figures, des encadrés, une page à l’italienne avec tout le plan et une quatrième de couverture avec un code QR qui ouvre le guide en ligne.

J’ai l’impression que beaucoup de gens ne savent pas ce qu’un document Word peut être. Word a de vrais styles, des figures avec des légendes numérotées, des notes de bas de page, des sections qui font pivoter une seule page à l’italienne, des cases à cocher et des polices intégrées. Je voulais voir ce qu’une IA en fait quand vous lui demandez quelque chose d’extraordinaire.

Pourquoi ce guide

J’ai demandé à Claude Code de choisir un guide adapté et pas trop court. Il a choisi celui-ci, pour deux raisons. Le guide est un plan: il décrit un cycle, quatre phases et sept étapes, sans en dessiner aucun. Et c’est le genre de texte que les gens transmettent à leur équipe de direction, là où un fichier Word se lit encore, s’imprime et s’annote.

Des images là où elles comptent

Le guide en ligne n’a qu’une image, l’illustration en haut de page. Mon prompt demandait des visuels là où ils comptent le plus. Claude Code a donc parcouru le texte à la recherche de ce qu’il décrit en mots et qui se comprend mieux en image. Il a dessiné huit figures:

• Le problème: les mêmes quatre personnes, chacune repartant de zéro dans son propre chat, à côté d’une mémoire partagée.
• Les trois ingrédients et la façon dont ils s’alimentent les uns les autres.
• Pourquoi l’effet se cumule: un chat vierge qui repart de zéro après chaque conversation, à côté d’un système qui garde ce qu’il apprend. La figure est présentée comme une esquisse, parce qu’aucune mesure ne la sous-tend.
• La boucle vertueuse, avec les quatre façons dont le système se corrige lui-même.
• Où va l’effort: environ 20 % de structure, 80 % de connaissances, et les quatre phases qui ont rempli le système.
• Les sept étapes sur une seule ligne.
• Comment les connaissances entrent, et ce que l’IA a le droit de lire.
• Tout le plan sur une page à l’italienne, à imprimer et à afficher.

D’autres parties sont devenues des éléments de Word plutôt que des images, pour rester modifiables: les quatre scénarios du quotidien et les cinq erreurs sous forme de cartes, la structure de dossiers en bloc de code à copier, la vérification du chapitre 9 en cases à cocher cliquables, et le désaccord entre notre CEO et moi sous forme de fiche avec les deux points de vue côte à côte, comme le guide propose de les consigner.

Un vrai fichier Word

• De vrais titres. Le volet de navigation de Word affiche chaque chapitre, la table des matières renvoie à chacun, et ses numéros de page sont des champs que Word peut mettre à jour.
• Des styles plutôt qu’une mise en forme au coup par coup. Paragraphe d’introduction, citation, carte, légende: chaque élément est un style nommé. Modifiez le style, et tout le document suit.
• Des notes de bas de page pour le papier. Les liens restent cliquables, et le premier lien vers chaque guide ou chaque test d’outil reçoit une note de bas de page avec son adresse. Même imprimé, le document vous dit où regarder.
• Les polices sont dans le fichier. Les polices de ce site sont intégrées. Sur un ordinateur qui ne les a pas, LibreOffice a quand même utilisé celles du fichier; Word devrait faire de même.
• Des descriptions pour les lecteurs d’écran. Chaque figure en a une, et le PDF est balisé, avec un signet pour chaque chapitre.
• Le code QR fonctionne. Un décodeur l’a lu avant qu’il n’aille sur la quatrième de couverture.

Comment il a été fait

Mon prompt complet se trouve en bas de cette page. Claude Code travaille directement dans le projet de ce site. Il avait donc dès le départ le guide, mes règles d’écriture et le design du site à portée de main.

Il a écrit le document sous forme de code: un script lit le guide et en construit le fichier Word. Le texte n’existe qu’une fois, dans le guide, et quand je modifie le guide, le document peut être reconstruit avec le nouveau texte. Chaque figure des chapitres est rattachée à une phrase du guide. Si je réécris cette phrase, la construction s’arrête et indique quelle figure a perdu sa place.

Ensuite, il a transformé chaque page en image et l’a regardée, sur de nombreux tours. Le premier rendu avait des problèmes que vous ne voyez qu’en regardant. Chaque figure était coupée à la hauteur d’une ligne de texte, à cause d’un réglage d’interligne que LibreOffice, qui transforme les pages en images, lisait comme une hauteur fixe. Les cases apparaissaient cochées alors qu’aucune ne l’était. Dans les figures, des libellés débordaient de leurs cadres, et plusieurs chapitres se terminaient par une seule ligne sur une page à part. Il a corrigé chaque problème et regardé à nouveau.

Pour finir, il a vérifié le fichier par rapport à la spécification du format Word. Cela a révélé ce qu’aucune image ne montre: tous les signets portaient le même numéro, ce que le format n’autorise pas.

Ce qui n’est pas parfait

• Personne ne l’a encore ouvert dans Word. Word ne tourne pas là où Claude Code travaille, toutes les vérifications et les aperçus d’ici ont donc été faits dans LibreOffice, une suite bureautique gratuite. Word peut couper une ligne ou une page à un autre endroit. Si un numéro de page de la table des matières est faux, cliquez dessus avec le bouton droit et choisissez « Mettre à jour les champs ».
• Chaque chapitre commence sur une nouvelle page, si bien que certains se terminent sur une page presque vide. C’est normal dans un rapport imprimé; à l’écran, cela fait beaucoup de blanc.
• Les figures sont des images. Vous pouvez modifier leurs légendes dans Word, mais pour changer un libellé à l’intérieur d’une figure, il faut changer le code qui la dessine.
• Le document n’existe qu’en anglais. Le guide existe aussi en allemand et en français, le document non.
• Le résumé et les libellés des figures sont écrits à part. Ils reprennent le guide en moins de mots. Si je change un fait dans le guide, il faut les revoir à la main. La construction ne vérifie que les phrases auxquelles les figures sont rattachées.
• Personne ne l’a vérifié dans Google Docs ni dans Apple Pages. Tous deux utilisent leurs propres polices au lieu des polices intégrées. Le PDF a le même aspect partout.

Ce que vous pouvez en retenir

• Demandez le format dont vous avez besoin, et dites qui va le lire. Un document pour une équipe de direction qui imprime demande d’autres choix qu’une page que les gens font défiler.
• Demandez des images là où le texte décrit une structure: un cycle, des étapes, un avant et un après, une comparaison. Laissez l’IA choisir les endroits et justifier ses choix. C’est un bon test pour savoir si elle a compris le texte.
• Gardez le texte à un seul endroit. Ce document est construit à partir du guide. Le long texte n’existe donc qu’une fois, et seuls les résumés courts demandent un second regard.
• Faites-lui regarder son propre travail, puis vérifiez ce que le regard ne voit pas. Les images des pages ont montré les figures coupées. Seule la vérification par rapport à la spécification du format a trouvé les signets en double.