Première utilisation

Grace donne à votre agent IA les consignes choisies pour votre projet. Une consigne d'expertise s'appelle un talent : par exemple, savoir écrire un test ou respecter l'architecture de votre application.

À la fin de ce guide, votre agent IA pourra consulter ces talents avant de travailler.

1. Retrouvez votre projet

Connectez-vous à Grace avec la méthode indiquée par votre équipe. Depuis l'accueil, ouvrez le projet sur lequel vous voulez travailler. Vérifiez son nom avant de continuer.

Sur la page de connexion, choisissez la langue dans le menu à drapeau, à côté du thème. Une fois connecté, retrouvez ce choix dans les paramètres de votre profil : il est enregistré sur votre compte pour vos prochaines visites et les nouvelles notifications.

Quel chemin suivre ?

Ce schéma résume le parcours dans Grace ; ce n'est pas une capture d'écran.

flowchart TD
  login["1. Connectez-vous"] -->|"Choisissez votre espace"| org["2. Votre organisation"]
  org -->|"Ouvrez votre projet"| project["3. Votre projet"]
  classDef step fill:#efecfe,stroke:#5948dc,color:#14151c
  class login,org,project step

• Étape du parcours
• Action pour passer à l’étape suivante

Vous avez réussi lorsque votre projet est ouvert dans la bonne organisation.

Je ne trouve pas mon projet ou mon organisation attend une approbation

Vérifiez avec un administrateur de votre équipe que vous avez rejoint la bonne organisation. Si elle attend une approbation, suivez l'indication de l'écran d'attente : reconnecter votre agent IA ne débloquera pas cet accès.

2. Vérifiez les talents actifs

Dans votre projet, le bandeau Préparation Grace indique immédiatement le nombre de talents actifs et de dépendances bloquantes. Votre équipe choisit ce que l'agent IA doit savoir faire ; vous n'avez pas besoin de tout installer.

Un talent peut avoir besoin d'un autre talent pour fonctionner : c'est une dépendance. Si Grace en signale une manquante, sélectionnez sa ligne pour voir quel talent la réclame et si elle est disponible au catalogue. Utilisez le bouton Installer [nombre] dépendances lorsque Grace propose l'action groupée. Une dépendance absente du catalogue reste signalée : ouvrez alors le talent concerné pour corriger sa référence avec la personne qui configure le projet.

Vous pouvez continuer lorsque les talents nécessaires sont actifs et que les dépendances signalées ont été traitées.

Il n'y a encore aucun talent

Demandez à la personne qui configure votre projet de choisir les talents adaptés. Grace propose aussi un parcours d'analyse du dépôt depuis l'agent IA ; il demande une validation humaine avant d'installer la sélection proposée.

Pour comprendre les choix possibles, consultez les talents.

3. Connectez votre agent IA

Ouvrez le guide de connexion du projet dans Grace.

1. Dans Agent IA, choisissez votre outil, puis sélectionnez votre Système d’exploitation.
2. Une fois les deux choix faits, copiez Brancher en une commande à la racine du dépôt. Grace fournit une commande sh sur macOS et Linux, ou PowerShell sur Windows. Elle prépare aussi les profils de relecture pour Claude Code et Codex. Le parcours manuel reste affiché juste dessous pour vérifier ou préparer chaque fichier séparément.
3. Suivez l’étape Authentifier et vérifier Grace adaptée à votre agent IA. Elle indique la commande de terminal ou l’action dans l’interface, puis le contrôle qui prouve que les outils Grace sont disponibles.

MCP est le moyen de communication entre votre agent IA et Grace.

Pour les autres outils, suivez le nom de fichier affiché après votre sélection.

La commande automatique écrit uniquement dans le projet courant. Windsurf ne proposant qu’une configuration MCP globale, Grace ne l’installe pas automatiquement et conserve le parcours manuel.

Vous avez réussi lorsque votre agent IA affiche Grace comme connecté et rend ses outils disponibles. La présence du fichier de configuration seule ne prouve pas que la connexion fonctionne.

4. Faites une première tâche

Demandez à votre agent IA une petite modification dont vous connaissez le résultat attendu :

Consulte les talents Grace adaptés, puis ajoute un test pour ce comportement. Explique ce que tu as vérifié.

Que doit faire l'agent IA ?

Le parcours attendu relie préparation, travail et vérification.

flowchart TD
  prepare["Consulter les talents utiles"] -->|"Appliquer les consignes"| work["Faire la modification"]
  work -->|"Contrôler le résultat"| check["Présenter les preuves"]
  classDef step fill:#efecfe,stroke:#5948dc,color:#14151c
  class prepare,work,check step

• Action de l’agent IA
• Ordre des actions

Ce schéma décrit le parcours attendu, pas une tâche déjà exécutée.

Vous avez réussi lorsque l'agent IA a consulté les talents adaptés et présente le résultat des vérifications. Un appel à Grace ne prouve pas, à lui seul, que le code est correct.

Un talent peut fournir des conventions utiles sans règles de revue. Grace le signale dès la préparation : l’agent continue d’appliquer ses conventions, mais ne demande pas son détail de revue inutilement. Le plan global reste consulté, même si tous les talents sont dans ce cas. Si les règles ont changé entre-temps, ce plan actualisé fait référence. Les consignes des talents de votre organisation restent à vérifier ; aucune absence de revue ne vaut conformité.

Quels appels puis-je reconnaître dans mon agent IA ?

grace_prepare_task fournit les consignes sélectionnées et un resolutionId, l'identifiant qui permet de retrouver le périmètre préparé. grace_review fournit ensuite le plan de revue. L'agent IA doit l’appliquer à ses changements et exécuter les contrôles demandés : Grace ne lit pas automatiquement son code local.

Si vous êtes bloqué

Pour aller plus loin : brancher un projet ou comprendre les outils MCP.