1. Accueil
  2. Tutoriels
  3. Écrire une carte qu’un agent comprend

Tutoriel · Capter · 5 minutes

Écrire une carte qu’un agent comprend

Un agent ne connaît ni votre client ni votre équipe. Tout ce qu’il doit savoir doit donc être dans la carte.

En bref

Pour quiToute personne qui crée des cartes
Il vous fautUn projet Exigaw et une carte à écrire
RésultatUne carte marquée « Contexte prêt pour un agent »

1. Écrivez un titre qui dit quoi faire

Commencez par un verbe, puis nommez l’objet précis.

  • Oui : Publier la page Tarifs du site de Maison Lenoir
  • Non : page tarifs
Pourquoi ? Dans une liste, l’agent ne voit souvent que le titre.

2. Expliquez le pourquoi et l’attendu

Dans la Description, écrivez deux petits paragraphes :

  1. Contexte : pourquoi cette tâche existe, ce qui a été décidé, et où c’est écrit.
  2. Objectif : à quoi ressemble le travail terminé.
Astuce. Mettez un lien plutôt que « voir le mail » : l’agent n’a pas accès à votre boîte. Tapez le numéro d’une autre carte, par exemple MAI-12, pour créer un lien vers elle.

3. Remplissez la checklist

  1. Dans la section Checklist, cliquez sur Ajouter un élément.
  2. Écrivez une condition qui se vérifie par oui ou par non.
  3. Recommencez pour chaque condition.
  • Oui : Page relue sur mobile
  • Non : Page réussie
Pourquoi ? La checklist dit quand c’est fini : l’agent sait quand s’arrêter, et vous savez quoi vérifier à son retour.

4. Joignez au moins une source

Dans la section Contexte joint, ajoutez ce sur quoi l’agent doit s’appuyer :

  • un lien : maquette, page de référence, ticket ;
  • un Document de votre base de connaissances ;
  • un fichier : l’agent sait le lire.

5. Complétez les propriétés

Renseignez les Assignés et la Priorité. Si le projet les utilise, ajoutez l’Échéance, l’Estimation et le Jalon.

6. Vérifiez la jauge de contexte

L’encadré Contexte pour un agent vérifie quatre points :

  1. une description de l’attendu ;
  2. une checklist pour savoir quand c’est fini ;
  3. une source (lien, document, fichier) ;
  4. un brief du projet, c’est-à-dire sa description.

Tant qu’un point manque, la jauge vous dit lequel. Quand tout y est, elle affiche Contexte prêt pour un agent.

À savoir. La jauge informe, elle ne bloque rien.

7. Transmettez la carte

  1. En haut de la carte, cliquez sur Transmettre.
  2. Cliquez d’abord sur Voir ce que l’IA lira : c’est le texte exact que reçoit un agent. Ce qui manque ici manquera à l’agent.
  3. Puis choisissez :
    • Copier le Markdown, à coller où vous voulez ;
    • Copier le lien de l’API, pour un agent qui lit Exigaw ;
    • Ouvrir dans Claude, Claude Code ou ChatGPT : une conversation s’ouvre, la carte déjà dedans.

Exemple complet

Avant, une carte qu’un agent ne peut que deviner :

page tarifs lenoir

Après, la même tâche, prête à confier :

Publier la page Tarifs du site de Maison Lenoir

## Contexte
Maison Lenoir lance son abonnement le 15 novembre.
La grille a été validée en réunion le 3 novembre :
elle est dans le Document « Offre 2027 ».

## Objectif
Une page Tarifs en ligne, au style du site, avec
les trois formules et un bouton vers le contact.

Checklist
[ ] Formules et prix conformes au Document
[ ] Page ajoutée au menu principal
[ ] Le bouton mène au formulaire de contact
[ ] Page relue sur mobile

Contexte joint
- Document « Offre 2027 »
- Lien vers la maquette

Et pour vos agents

L’assistant intégré et les agents branchés par MCP lisent exactement cette carte. Bien écrite une fois, elle sert partout.

À lire ensuite

Essayez sur une vraie carte

Trente minutes sur l’un de vos projets pour voir ce qu’un agent devrait y trouver.

Demander une démo Tous les tutoriels