Aller au contenu
← Articles IA

Agents IA · Méthode

Analyse de mon instruction pour mes assistants IA

9 min de lecture

Plusieurs assistants travaillent sur les mêmes projets que moi. Chacun avait sa propre consigne, écrite à un moment différent. Je les ai remplacées par un seul texte, le même pour tous. Le voici, avec les noms remplacés, et ce que chaque partie cherche à éviter.

L’article en 30 secondes

  • La consigne ne nomme aucun assistant : celui qui la reçoit a les mêmes droits et les mêmes limites que les autres.
  • Avant de reprendre un projet, l’assistant lit les règles à jour dans le dépôt. Il n’interroge la mémoire qu’ensuite.
  • Un seul assistant publie par mission, et rien n’est fusionné sans mon accord.
  • Une consigne reste un texte. Elle organise le travail, elle ne remplace pas une limite technique.
Une longue consigne en anglais apparaît en caractères multicolores sur un écran bleu nuit, avec un flou progressif vers la droite.
Illustration générée par IA.

Un assistant commence une tâche le matin. Un autre la reprend l’après-midi. Si chacun suit ses propres règles, le second peut défaire ce que le premier a fait, ou repartir d’une décision que j’ai annulée entre-temps.

C’était ma situation. Ma consigne générale était écrite du point de vue d’un seul assistant, et les autres recevaient des variantes. Chaque nouvelle décision obligeait à corriger plusieurs textes.

J’ai donc fait l’inverse : un texte unique, qui ne nomme personne. Il complète mon dossier sur le harness, l’ensemble des outils et mécanismes qui encadrent le travail des assistants. Ici, je montre la règle du jeu qui les relie.

Ce texte est le point d’entrée commun ; les règles propres à chaque projet restent dans le dépôt.

Dans les extraits, j’ai remplacé le nom du dépôt, des outils et du compte de test par des repères entre chevrons.

Pourquoi la consigne est en anglais

Je parle français à mes assistants et ils me répondent en français. La consigne, elle, est rédigée en anglais, pour deux raisons.

L’anglais peut demander moins de tokens. Un modèle traite le texte en tokens, des unités qui peuvent correspondre à des mots ou à des fragments de mots. Selon le découpage utilisé, un même contenu peut demander moins de tokens en anglais. Une étude présentée à NeurIPS 2023 a mesuré l’écart sur les mêmes phrases traduites : sur le corpus étudié, avec le découpage utilisé à l’époque par ChatGPT et GPT-4, les textes demandaient en moyenne environ 1,6 fois plus de tokens en français qu’en anglais. [1] Lorsque la consigne est chargée dans une conversation, cet écart augmente le volume de tokens traité ; il ne correspond pas nécessairement à un surcoût facturé à chaque chargement.

Certaines études donnent aussi des raisons de privilégier l’anglais. Des chercheurs ont comparé deux façons d’interroger un modèle multilingue sur cinq tâches : lui faire d’abord traduire la question en anglais donnait de meilleurs résultats que la traiter directement dans la langue d’origine. [2] Une autre équipe a observé que, dans les modèles Llama-2, l’espace des concepts est plus proche de l’anglais que des autres langues. [3]

Je reste prudent sur ce second point. Ces travaux portent sur des modèles et des tâches précis. Ils ne démontrent pas qu’une consigne en anglais est mieux suivie par les assistants que j’utilise, et je n’ai pas trouvé de mesure équivalente pour le français avec ces assistants. Le chiffre sur les tokens dépend lui aussi du découpage, qui change d’une génération de modèles à l’autre. Je retiens l’anglais comme un choix pratique, sans garantie de meilleurs résultats.

Le principe : la confiance par défaut, les limites par écrit

Extrait 1 · Ouverture
Applies to every AI agent given this instruction. Each is trusted by default, with the same permissions and limits: whatever is not restricted here or in the repository instructions is allowed within the approved scope. Reply to <user> in French unless he asks otherwise. Reuse approvals that still apply, and distinguish verified facts, assumptions, and unknowns.

Cette ouverture règle trois choses.

  • Qui est concerné. Tout assistant qui reçoit le texte. Je n’ai plus à écrire « l’assistant A a les mêmes droits que l’assistant B ».
  • Ce qui est permis. Tout ce que la consigne ou le dépôt n’interdit pas, dans le périmètre de la mission. Je liste les interdits, pas les autorisations.
  • Comment répondre. En distinguant ce qui est vérifié, ce qui est supposé et ce qui est inconnu.

Le choix de la confiance par défaut a une conséquence directe : donner ce texte à un assistant, c’est l’habiliter. Je ne le colle donc que là où j’accepte cette conséquence.

Le démarrage : lire avant de se souvenir

Extrait 2 · Démarrage et reprise d’un projet
When starting, switching, or resuming a project:
1. Use the existing <GitHub connector> to read <owner>/<repository>. If it is unavailable, ask <user> to validate another live remote query before using it. Read the live refs/heads/main first, then pin all instruction reads to that commit. A cached ref, local checkout, prior chat, or memory cannot establish current main.
2. Read the root AGENTS.md and README.md, the applicable project AGENTS.md and README.md, any applicable AGENTS.override.md, and the canonical sections needed for the task. Report the verified SHA and paths read.
3. Only after those reads, make one short, scoped English Recall on <shared memory>. Reconcile relevant memories with the pinned sources and report material conflicts or superseded decisions.
4. For a branch handoff, verify the live branch tip and changes since the recorded commit. Resume only the assigned open step and respect its scope and owner. Never reopen a closed handoff.

C’est la partie la plus importante, et tout tient dans l’ordre. Dans Git, qui conserve l’historique des fichiers, une branche est une ligne de travail ; main désigne ici la branche principale. Un commit enregistre une version des fichiers et possède un identifiant unique.

L’ordre de démarrage : les règles d’abord, la mémoire ensuite
  1. 1 · Lire la branche principaleL’état réel du dépôt, pas une copie
  2. 2 · Épingler et lire les règlesToutes les lectures sur le même commit
  3. 3 · Interroger la mémoireUne seule requête, courte et ciblée
  4. 4 · Reprendre l’étape ouverteCelle qui est assignée, pas une autre

Aucun appel à la mémoire avant la fin de l’étape 2.

Pourquoi cet ordre ? Une mémoire partagée garde des décisions datées. Si l’assistant la consulte en premier, il peut appliquer une règle que j’ai remplacée depuis. En lisant d’abord le dépôt, il sait ce qui fait foi aujourd’hui, puis il compare.

Qui fait autorité en cas de désaccord
  1. Les sources de référence du dépôtRègles et décisions validées, à la révision vérifiée
  2. La mémoire partagéeContexte daté, à confronter au dépôt
  3. La conversation précédenteNe prouve rien sur l’état actuel

Ce classement ne dispense pas de prendre en compte mes instructions explicites pour la mission. Un document récemment ajouté au dépôt peut être une proposition : sa présence ne suffit pas à en faire une décision validée.

Deux détails comptent. L’assistant épingle ses lectures sur un commit précis : il ne lit pas la moitié des règles avant une modification et l’autre moitié après. Et il rapporte l’identifiant de ce commit et les fichiers lus. Je peux vérifier d’un coup d’œil qu’il part de la bonne version.

La dernière étape protège le travail des autres : un assistant reprend l’étape qui lui est confiée, et ne rouvre jamais un relais déjà clos.

La publication : un seul responsable par mission

Extrait 3 · Publication
One publisher per mission. Use main for routine documentation and a branch prefixed with your agent name for code or configuration requiring review, subject to the assigned branch and project rules. Merge only with <user>'s explicit authorization. Follow the current root AGENTS.md for Git closure. Preserve unrelated work, prepare the required backup and rollback, run declared checks, review the exact staged changes and outgoing commits, and verify the remote result. Stop on unclear ownership, divergence, failed checks, or denied writes. Never force-push, reset destructively, or bypass a refusal with a broader credential. Git publication does not authorize deployment.
Le circuit des changements soumis à revue
  1. Un seul assistant publieJamais deux sur la même mission
  2. Il vérifieSauvegarde, tests déclarés, relecture de ce qui part
  3. Il pousse sa branchePuis contrôle le résultat à distance
  4. Je donne mon accordSans lui, pas de fusion

Arrêt immédiat si la propriété du travail est floue, si la branche a divergé, si un test échoue ou si une écriture est refusée.

Ce schéma concerne les changements préparés sur une branche dédiée, puis fusionnés dans la branche principale. La consigne prévoit aussi un autre cas : la documentation courante peut être publiée directement sur main, selon les règles du projet, sans étape de fusion.

Trois idées structurent ce paragraphe.

  • Un seul responsable de publication par mission. Cette règle désigne celui qui envoie les changements dans le dépôt distant ; elle n’interdit pas à plusieurs assistants de contribuer à leur préparation. Des publications concurrentes risquent de produire des conflits que je dois ensuite démêler.
  • S’arrêter vaut mieux que forcer. Les cas d’arrêt sont écrits. Un refus d’écriture ne se contourne pas avec un accès plus large.
  • Publier n’est pas déployer. Pousser du code dans le dépôt ne donne pas le droit de le mettre en production.

Les accès : signaler le manque plutôt que le combler

Extrait 4 · Identifiants
Use existing credentials and protected procedures. Direct access to the Mac Keychain requires native macOS execution; virtual or remote Linux sessions cannot access it directly. Report unavailable capabilities. Never expose secrets or export credentials or authentication caches to bridge an access gap. Trust does not change GitHub settings, OAuth grants, account boundaries, or professional freezes.

Les mêmes droits ne signifient pas les mêmes moyens. Un assistant qui tourne sur mon Mac peut utiliser le trousseau. Le même assistant, lancé dans un environnement distant, ne le peut pas.

Le risque est qu’il cherche à combler l’écart, par exemple en copiant un jeton d’un endroit à l’autre. La consigne demande l’inverse : dire ce qui manque, et s’arrêter là.

La dernière phrase borne la confiance. Elle ne modifie ni les réglages du dépôt, ni les autorisations déjà accordées aux connexions, ni les périmètres que j’ai gelés.

Les outils : pouvoir n’est pas être autorisé

Extrait 5 · Connecteurs et navigateur
Prefer an existing authorized connector, then a documented API, then a local CLI. For authorized reads of <test account>, use <connector>, verify the connected identity, and inspect the actual source content. Tool capabilities do not grant authority to write, send, share, or create workflows.

Computer-use control of AI assistant apps is not authorized, including for account settings and fresh-chat checks. For separately and explicitly authorized browser tasks, use <browser> through its extension within the approved scope. Do not use browser control to bypass this restriction.

Une connexion technique accorde souvent plus que ce dont j’ai besoin. Un connecteur de messagerie qui sait lire sait généralement aussi envoyer. La consigne sépare ce que l’outil peut faire de ce que j’autorise. C’est la distinction que je détaille dans l’article sur les courriels piégés.

Dans mon organisation, je privilégie un connecteur dédié pour obtenir des réponses structurées et limiter les manipulations d’interface. À défaut, la consigne prévoit une API, une interface de programmation, puis une CLI, un outil en ligne de commande. C’est un choix pratique, pas une garantie générale de coût ou de fiabilité.

Le second paragraphe interdit à un assistant de piloter l’application d’un autre assistant, y compris pour en modifier les réglages. Je garde cette action pour moi.

Ce qu’une formulation plus courte peut faire perdre

Raccourcir une consigne peut faire disparaître une règle. Voici trois exemples où quelques mots précisent la branche à utiliser, les vérifications à faire ou l’autorisation à obtenir.

Formulation complèteFormulation abrégéeContrainte perdue
« subject to the assigned branch and project rules »« subject to project rules »L’obligation de rester sur la branche assignée
« review the exact staged changes and outgoing commits »« staged-diff review »La vérification des commits sortants ; la relecture des modifications indexées reste mentionnée
« Git publication does not authorize deployment »« Publication is not deployment »L’exigence d’une autorisation distincte pour déployer

Dans une consigne, quelques mots peuvent porter une limite entière. Un texte commun simplifie la mise à jour des règles tout en gardant ces limites explicites.

Ce que cette consigne ne fait pas

  • Elle n’empêche rien techniquement. Un assistant trompé ou mal configuré peut l’ignorer. Les vraies barrières restent les droits des comptes et des connexions.
  • Elle a un coût. Lorsqu’elle est chargée, elle occupe une partie du contexte disponible, même si la question n’a aucun rapport avec mes projets.
  • Elle dépend du dépôt. Les détails vivent dans les fichiers de règles. Si le connecteur est indisponible, l’assistant doit le dire et attendre mon accord pour passer par une autre voie.

La méthode s’applique avec d’autres outils. Elle repose sur des sources de référence, un ordre de lecture, un seul responsable de publication par mission et des limites écrites.

Si plusieurs assistants travaillent pour vous, la question à poser est courte : lisent-ils tous la même règle, et dans le même ordre ?

Sources et références

  1. Petrov et al. — Language Model Tokenizers Introduce Unfairness Between Languages (NeurIPS 2023)↩
  2. Etxaniz et al. — Do Multilingual Language Models Think Better in English?↩
  3. Wendler et al. — Do Llamas Work in English? On the Latent Language of Multilingual Transformers↩