Install
https://github.com/Gentleman-Programming/gentle-ai/blob/main/docs/quickstart.mdPara quién es
Ya usas un agente de programación con IA y una y otra vez te topas con lo mismo: en cuanto termina de escribir el código, vacía el contexto y la siguiente ronda vuelve a empezar de cero; no tiene un criterio estable sobre tu proyecto; y cuando acaba, la única forma de demostrar qué cambió realmente es leer tú mismo el diff línea por línea.
Gentle-AI apunta exactamente a esa realidad cotidiana. No sustituye tu agente: superpone a tu agente actual un entorno de ingeniería determinista, que la documentación oficial resume como "The deterministic engineering environment". Todo se reduce a tres cosas: memoria, flujo de trabajo y evidencias.
Encaja para desarrolladores que tienen un repositorio real y quieren que el agente recuerde las convenciones del proyecto a largo plazo; para responsables de equipo que prefieren que el agente avance siguiendo un proceso fijo en lugar de improvisar cada vez; y para situaciones en las que cada cambio debe dejar un registro contrastable que facilite la colaboración y los relevos.
Al revés, no cubre las ganas de cambiar de editor o de modelo: regula la forma de trabajar de tu agente actual, no la herramienta que utilizas. Si solo se trata de un script de un solo uso y no necesitas trazabilidad, plantéate primero si compensa añadir una capa más de configuración.
Primer intento en 3 minutos
Sigue solo el camino oficial: abre el Quickstart.
https://github.com/Gentleman-Programming/gentle-ai/blob/main/docs/quickstart.md
Requisitos previos: ya tienes instalado un agente compatible (por ejemplo, Claude Code) y le permites leer y escribir en el directorio del proyecto. Gentle-AI no ofrece un agente propio: solo se encarga de escribir la configuración en el que ya tienes. La documentación oficial declara 17 integraciones y las diferencias entre agentes están recogidas en docs/agents.md; esa tabla comparativa también te dice qué capacidades puede obtener cada agente.
Antes de empezar, dedícate un minuto a leer esa tabla y comprueba que el agente que usas a diario aparece en ella. Si no aparece, cambia de agente antes de hablar de configuración: rodear la exigencia solo te dará un entorno que no se puede instalar y cuyo efecto tampoco sabrás explicar.
La ubicación de la instalación es el directorio de destino que indique la sección del Quickstart para tu agente. La página de inicio solo dice que hace configuración nativa y no detalla las rutas en disco de cada agente, así que no adivines directorios de memoria ni copies la ruta de otro agente.
Una vez instalado, no le pidas rehacer el proyecto de golpe. Dale primero una tarea de solo lectura: que recorra la estructura del proyecto, exponga cómo piensa entender el repositorio y presente un plan antes de tocar nada. Ese paso no escribe archivos ni ejecuta comandos, con lo que el riesgo es mínimo. Cuando se trate de escribir archivos, ejecutar shell o lanzar peticiones externas, haz que enumere uno por uno los archivos que va a cambiar y las acciones que va a ejecutar, y no lo autorices hasta que confirmes.
Hay dos señales de éxito observables: cambia de sesión y el agente sigue sabiendo enunciar las convenciones que ya existían en tu proyecto, lo que demuestra que la memoria quedó en disco; y dentro de una misma sesión sigue un proceso fijo —primero el plan, luego la acción, luego un registro contrastable— en lugar de limitarse a devolver una respuesta. La descripción oficial del recorrido completo es: un solo prompt lleva hasta un commit con resultado de revisión.
Casos de uso
Caso uno: un prompt, desde la idea hasta un commit con resultado de revisión. El apartado de la página de inicio del repositorio demuestra precisamente esa línea: la memoria recupera el contexto del proyecto, el flujo de trabajo restringe los pasos y las evidencias explican los cambios. Ahí terminan las evidencias: la página de inicio muestra la cadena, pero sin detalles de interfaz paso a paso; el orden real y los artefactos se rigen por el Quickstart y docs/intended-usage.md.
Caso dos: añadir al agente memoria, flujo de trabajo y evidencias contrastables. El método es escribir la configuración del agente elegido siguiendo el Quickstart; las opciones que la documentación oficial enumera incluyen memoria persistente, skills seleccionadas, servidores MCP y personas. Conviene tener en cuenta que la página de inicio solo da los nombres de estos elementos de configuración y no dice qué archivo corresponde a qué agente ni cuál manda en caso de conflicto; eso hay que contrastarlo en docs/agents.md y en la documentación de cada agente.
Lo que ambos casos tienen en común: no hace falta sustituir el agente que ya usas; lo único que se suma son dos cosas, recordar y explicar. La página de inicio no ofrece datos cuantificados de mejora en eficiencia o calidad, así que no esperes que te demuestre el beneficio.
Límites de uso
Es una capa de configuración, no un agente nuevo ni un IDE: hace falta antes un agente compatible, para que la configuración tenga dónde apoyarse. La documentación oficial declara 17 integraciones y la página de inicio solo nombra una parte; para saber si un editor o una herramienta de línea de comandos está en la lista, consulta la tabla comparativa de docs/agents.md y no des por hecho que todo funciona.
La página de inicio describe la segunda validación únicamente como opcional y de alcance limitado, sin dar umbrales de decisión ni escenarios de aplicación: no la tomes como una barrera de calidad y sigue revisando tú mismo los cambios importantes.
Los detalles sobre la ubicación de la instalación y dónde acaba cada elemento de configuración están dispersos en la documentación de cada agente; la página de inicio solo da la entrada, así que cuando copies rutas comprueba a qué agente pertenece la sección.
La documentación, el sitio oficial y el wiki son hoy todo en inglés: copia comandos y rutas tal cual y vigila las mayúsculas y minúsculas. La página de inicio del repositorio además enlaza con el sitio oficial y con el wiki, así que ante una duda de configuración de un agente concreto puedes buscar primero ahí una respuesta ya existente.