À propos du projet

Gentle-AI est un environnement d'ingénierie déterministe superposé aux agents de codage IA que vous possédez déjà. Plutôt que de fournir son propre agent, il configure ceux existants — le README liste 16 intégrations, dont Pi, OpenCode, Claude Code, Codex, Cursor, VS Code Copilot, Gemini CLI, Kilo Code, Kimi Code, Kiro IDE, Qwen Code, Hermes, Antigravity, Windsurf, OpenClaw et Trae. Chaque intégration utilise les capacités natives de l'agent, donc des fonctionnalités comme la délégation et la revue peuvent différer selon l'agent. Idées centrales décrites dans le README : - Engram : mémoire de projet persistante. L'agent enregistre les décisions au fur et à mesure et consulte cette mémoire avant de redemander à l'utilisateur, afin que le contexte s'accumule entre les sessions et la compaction du contexte, au lieu de se réinitialiser. - ODD (Organic Driven Development) : maintient les petites modifications comprises légères tout en donnant aux travaux substantiels autorisés un document de fonctionnalité unique et récupérable, afin que le travail puisse reprendre sans reconstruire un plan. - TDD strict : lorsqu'il est activé, un test de comportement échouant est capturé avant l'implémentation, puis rendu passant, puis refactorisé avec les tests verts. Lorsqu'il est désactivé, les vérifications fonctionnelles applicables s'exécutent toujours. - RDD (Receipt-Driven Development) : activé par défaut et désactivable via `gentle-ai review mode disable`. Le changement candidat est figé avant la revue, la profondeur de revue est dérivée de ce candidat figé (lecture structurelle passive, une lentille ciblée, ou une revue à quatre lentilles Risque/Résilience/Lisibilité/Fiabilité), au plus une correction bornée est autorisée, et les résultats sont informatifs — commit, push et release restent la décision de l'utilisateur. - Transitions déterministes : un binaire `gentle-ai` lit l'état du changement depuis des fichiers sur disque et renvoie la prochaine transition valide, avec quatre états publics (Working, Checking, Ready, Needs your decision) plutôt qu'un jugement de modèle. - Gentle Shell : un paquet d'intégration Pi séparé avec son propre runtime, agents et interface ; installer le binaire n'établit pas en soi la parité de comportement Pi. Composants supplémentaires inclus : une bibliothèque de compétences chargée lorsque les tâches correspondent, un MCP Context7 optionnel pour la documentation vivante des frameworks/bibliothèques, un graphe de symboles CodeGraph en lecture seule, une liste de refus de sécurité bloquant l'accès à `~/.ssh`, `.env` et fichiers d'identifiants, des instantanés de configuration avant chaque écriture, un rapport de santé `gentle-ai doctor` en lecture seule, des personas optionnels (Gentleman), des thèmes, et une assignation de modèles pour les agents et rôles de revue pris en charge. Les options d'installation affichées sont Homebrew sur macOS, un script curl pour macOS/Linux, et une installation source Go sur Windows nécessitant Go 1.25.10+. Après installation, lancer `gentle-ai` invite à choisir agents, composants et persona ; le README indique que l'outil n'installe jamais lui-même un agent IA et prend des instantanés des configurations avant les écritures. La documentation couvre l'usage prévu, le démarrage rapide, la matrice de fonctionnalités par agent, le routage ODD, l'architecture de revue, Engram, les composants, la contribution, la télémétrie (avec désactivation possible) et un guide du codebase. Le projet est sous licence MIT, avec des avis de marque pour les noms Gentle AI et Engram.