Gentle Shell : évaluer l'adéquation de ce harness Pi de développement contrôlé et faire un premier essai

À qui il s'adresse

Gentle Shell s'adresse aux développeurs qui utilisent déjà Pi comme agent de codage, veulent un développement contrôlé et attendent de l'agent qu'il explore avant de toucher au code, qu'il ne pose des questions qu'aux vrais points de décision et qu'il conserve en petites étapes le travail petit et bien compris. Le flux de travail quotidien porte un nom officiel, Organic Driven Development (ODD) : l'agent explore avant de changer quoi que ce soit, ne clarifie que les vraies décisions et garde le travail petit et compris en petites étapes. Une fois installé, une session Pi ordinaire devient un plan de travail : orchestration des agents, changements en direct et état d'exécution, suivi de consommation pour les comptes des fournisseurs pris en charge et vues de diff intégrées se retrouvent dans une même interface. La documentation officielle mentionne aussi SDD/OpenSpec (optionnel), ainsi que subagents, preuves TDD, review guardrails, skills et intégrations memory.

Cas où cela convient moins ou préalables : si vous n'utilisez pas Pi, la documentation officielle ne dit rien d'une exécution dans d'autres agents. Jusqu'à la fin de la migration officielle, le paquet npm comme le dépôt s'appellent gentle-pi ; le nom du produit et celui du paquet ne coïncident donc pas. Les systèmes d'exploitation requis et la version de Pi nécessaire ne sont pas mentionnés — à vérifier vous-même avant d'installer.

Un premier essai en 3 minutes

Commencez par accepter un effet de bord à l'installation que la documentation officielle énonce clairement : gentle-pi remplace l'extension codemode intégrée de Pi par son propre compact renderer, et ensuite Pi avertit à chaque démarrage que la version intégrée n'a pas été chargée. Autrement dit, cet effet de bord se produit à l'étape d'installation, pas pendant l'exécution d'une tâche ; décider d'installer ou non, c'est décider de l'accepter ou non. Si vous dépendez du comportement du codemode intégré, évaluez-le d'abord ; les autres peuvent considérer cet avertissement au démarrage comme un phénomène attendu.

Le chemin principal recommandé est unique : installez globalement dans un terminal avec npm i -g gentle-pi. Après l'installation, lancez gentle-shell : il ouvre Pi et charge le paquet Gentle Shell depuis son propre répertoire personnel ~/.gentle-shell/agent ; pour charger depuis un ~/.pi/agent existant, ajoutez --link au lancement. Ce n'est que la commutation officielle de l'emplacement de chargement, pas une seconde méthode d'installation — les deux emplacements figurent dans la documentation officielle, choisissez-en un.

Selon la description officielle, il y a deux signaux de réussite : d'abord, ce qui s'ouvre après le lancement est une session Pi avec le paquet Gentle Shell chargé ; ensuite, apparaît l'avertissement au démarrage disant que le codemode intégré n'a pas été chargé — précisément la preuve que le remplacement a pris effet. Les deux se constatent sur le premier écran après le lancement, sans devoir exécuter d'abord une tâche qui modifie quoi que ce soit. Pour la première tâche, choisissez-en une petite et purement analytique portant sur du code, par exemple demander à l'agent de lire un module et d'expliquer sa structure et ses relations d'appel, sans rien modifier pour l'instant. Le chemin ODD consiste par nature à explorer d'abord, donc cette phase ne produit aucun changement ; quant à savoir si l'agent écrit directement des fichiers, exécute des commandes ou accède au réseau lors des tâches suivantes, la documentation officielle ne le dit pas — ne le traitez pas comme un fait confirmé et vérifiez-le dans la session avant d'agir.

Cas d'usage

Cas un : comprendre du code inconnu. Lancez dans la session une tâche de ce type : lire d'abord un module donné, expliquer ses responsabilités et ses dépendances, ne modifier aucun fichier. On suit le chemin quotidien ODD — l'agent explore d'abord et ne pose de questions que sur les vrais points de décision, les petites tâches restent petites. Si l'agent pose des questions après avoir exploré, elles devraient, selon la description officielle de l'ODD, être celles qui affectent réellement les décisions. Le résultat attendu est une explication fondée sur cette exploration ; le format de réponse n'est pas défini officiellement, fiez-vous à ce que la session sort réellement.

Cas deux : vérifier tout en modifiant. Faites faire à l'agent une petite modification tout en contrôlant chaque changement dans la vue de diff intégrée ; les panneaux des changements en direct et de l'état d'exécution montrent ce que fait l'agent, et si votre compte appartient à un fournisseur pris en charge, le suivi de consommation apparaît dans la même interface. La valeur de ce cas tient à la visibilité du processus de modification : les vues sont fournies officiellement, les modifications viennent de la tâche, et l'on peut confronter les deux. Ce qui est modifié se décide avec l'agent dans la session ; la documentation officielle ne couvre que ces vues et capacités d'état et ne garantit pas la qualité des réécritures.

Limites d'usage

Effets de bord et points de confirmation : installer gentle-pi remplace le codemode intégré de Pi (le compact renderer prend le relais), et l'avertissement au démarrage est un phénomène attendu, pas une panne. Au-delà, la documentation officielle ne dit rien de l'étendue de l'exécution de commandes, de la lecture-écriture de fichiers ni de l'accès réseau — on ne sait pas si ces comportements se produisent, ne partez pas du principe que l'outil est en lecture seule. La documentation ne dit rien non plus de la manière dont les changements produits en session sont écrits sur disque ni de la confirmation étape par étape ; observez le comportement réel de l'agent dans la session avant de décider de continuer.

Prérequis d'exécution : destiné aux sessions Pi, installé globalement via npm ; l'usage dans d'autres agents et les langages de code ou de texte pris en charge ne sont pas mentionnés. Limites officiellement énoncées : le paquet npm et le dépôt restent gentle-pi jusqu'à la fin de la migration, la divergence entre nom du produit et nom du paquet persiste donc ; --link ne fait que changer l'emplacement de chargement du paquet. Restent à confirmer : comment le configurer et le désinstaller, si le codemode intégré est restauré après désinstallation, et comment activer SDD/OpenSpec, subagents, preuves TDD, review guardrails, skills et intégrations memory — la documentation ne les cite que comme capacités, sans donner de procédure.