Gentle-AI pour commencer : ajouter mémoire, workflow et preuves à un agent de codage IA existant

À qui cela s'adresse

Vous utilisez déjà un agent de codage IA et vous retombez sans cesse sur la même chose : dès qu'il a fini d'écrire le code, il vide le contexte et repart de zéro au tour suivant ; il n'a pas de jugement stable sur votre projet ; et une fois le travail terminé, la seule façon de prouver ce qu'il a réellement changé est de lire vous-même le diff, ligne par ligne.

Gentle-AI s'adresse précisément à ce quotidien. Il ne remplace pas votre agent : il superpose à l'agent que vous utilisez déjà un environnement de développement déterministe, que la documentation officielle résume par "The deterministic engineering environment". Tout porte sur trois points : la mémoire, le workflow et les preuves.

C'est fait pour les développeurs qui ont un vrai dépôt et veulent que l'agent retienne les conventions du projet sur la durée, pour les responsables d'équipe qui préfèrent voir l'agent avancer selon un processus fixe plutôt que d'improviser à chaque fois, et pour les situations où chaque modification doit laisser une trace vérifiable, pour faciliter la collaboration et les passations.

À l'inverse, il ne répond pas aux envies de changer d'éditeur ou de modèle : ce qu'il régit, c'est la manière de travailler de votre agent actuel, pas l'outil que vous employez. S'il ne s'agit que d'un petit script jetable, sans besoin de traçabilité, demandez-vous d'abord si une couche de configuration supplémentaire en vaut la peine.

Premier essai en 3 minutes

Suivez la seule voie officielle : ouvrez le Quickstart.

https://github.com/Gentleman-Programming/gentle-ai/blob/main/docs/quickstart.md

Prérequis : un agent pris en charge (Claude Code, par exemple) est déjà installé et autorisé à lire et à écrire dans le répertoire du projet. Gentle-AI ne fournit pas d'agent : il se contente d'écrire la configuration dans celui que vous avez déjà. La documentation officielle annonce 17 intégrations, et les différences entre agents sont consignées dans docs/agents.md ; ce tableau comparatif indique aussi quelles capacités chaque agent peut obtenir.

Avant de commencer, consacrez une minute à ce tableau et vérifiez que l'agent que vous utilisez quotidiennement y figure. S'il n'y figure pas, changez d'agent avant de parler configuration : contourner l'avertissement ne vous donnera qu'un environnement qu'on ne peut pas installer et dont on ne peut pas expliquer l'effet.

L'emplacement d'installation est celui indiqué dans la section du Quickstart consacrée à l'agent que vous utilisez. La page d'accueil précise seulement qu'il s'agit d'une configuration native, sans détailler les chemins d'écriture de chaque agent : ne devinez donc pas les répertoires de mémoire et ne recopiez pas le chemin d'un autre agent.

Une fois installé, ne lui demandez pas aussitôt de refondre le projet. Donnez-lui d'abord une tâche en lecture seule : parcourir la structure du projet, expliquer comment il compte comprendre ce dépôt, et exiger un plan avant toute action. Cette étape n'écrit aucun fichier et n'exécute aucune commande, le risque est minimal. Quand il s'agit d'écrire des fichiers, d'exécuter du shell ou de déclencher des requêtes externes, faites-lui lister un par un les fichiers à modifier et les actions à mener, puis ne l'autorisez qu'après votre confirmation.

Deux signaux de succès sont observables : changez de session et l'agent sait encore énoncer les conventions déjà en place dans votre projet, ce qui montre que la mémoire a été écrite sur le disque ; et, dans une même session, il suit un processus fixe – plan d'abord, puis action, puis une trace vérifiable – au lieu de se contenter de renvoyer une réponse. La description officielle du chemin complet est la suivante : une seule invite mène jusqu'à un commit accompagné d'un résultat de relecture.

Cas d'usage

Premier cas : une invite, de l'idée au commit accompagné d'un résultat de relecture. C'est exactement cette ligne que démontre la section correspondante de la page d'accueil du dépôt : la mémoire récupère le contexte du projet, le workflow contraint les étapes, les preuves expliquent les modifications. Les preuves s'arrêtent là – la page d'accueil montre cette chaîne mais sans détail d'interface étape par étape ; l'ordre réel et les livrables font foi : Quickstart et docs/intended-usage.md.

Second cas : ajouter à l'agent la mémoire, le workflow et des preuves vérifiables. La méthode consiste à écrire la configuration de l'agent choisi conformément au Quickstart ; les options listées officiellement comprennent la mémoire persistante, des skills sélectionnés, des serveurs MCP et des personas. Attention : la page d'accueil ne donne que les noms de ces éléments de configuration, sans dire quels fichiers correspondent à quel agent ni lequel l'emporte en cas de conflit ; pour cela, revenez à docs/agents.md et à la documentation propre à chaque agent.

Ce que les deux cas ont en commun : vous n'avez pas à remplacer l'agent que vous utilisez, vous gagnez seulement deux choses, mémoriser et expliquer. La page d'accueil ne fournit aucune donnée chiffrée sur le gain d'efficacité ou de qualité : ne comptez pas sur elle pour vous prouver le bénéfice.

Limites d'usage

C'est une couche de configuration, ni un nouvel agent ni un nouvel IDE : il faut d'abord un agent pris en charge, sinon la configuration n'a nulle part où se poser. La documentation officielle annonce 17 intégrations, et la page d'accueil n'en cite qu'une partie ; pour savoir si un éditeur ou un outil en ligne de commande y figure, consultez le tableau comparatif de docs/agents.md, sans supposer que tout est pris en charge.

La page d'accueil ne décrit la seconde validation que comme facultative et à portée limitée, sans fournir de seuil de décision ni de cas d'application : ne la prenez pas pour une barrière qualité, les modifications importantes restent à relire par vous-même.

Les détails sur l'emplacement d'installation et la destination de chaque élément de configuration sont dispersés dans la documentation de chaque agent ; la page d'accueil ne fournit que le point d'entrée : lorsque vous recopiez un chemin, vérifiez bien à quel agent la section correspond.

La documentation, le site officiel et le wiki sont aujourd'hui entièrement en anglais : recopiez les commandes et les chemins tels quels, en veillant à la casse. La page d'accueil du dépôt affiche deux entrées, vers le site officiel et vers le wiki : pour un problème de configuration propre à un agent, commencez par y chercher une réponse existante.