¿Qué es gentle-ai?

gentle-ai es el stack de agentes de IA para desarrolladores de Gentleman Programming. No es un plugin ni una extensión — es un sistema de seis componentes que trabajan juntos para convertir cualquier agente de IA en un asistente de desarrollo completo.

El problema con la mayoría de los agentes de IA es que no tienen memoria entre sesiones, no conocen tu stack, no hacen code review y solo ejecutan órdenes sin explicar nada. gentle-ai resuelve todo eso con un solo comando de instalación.

Instalación

gentle-ai se instala con un solo comando. El script configura todos los componentes automáticamente.

macOS y Linux

curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 | iex

Flags disponibles

Podés personalizar la instalación con los siguientes flags:

# Instalar solo componentes específicos
./install.sh --only=engram,sdd,skills

# Instalar sin GGA (sin code review automático)
./install.sh --skip=gga

# Modo verbose para debug
./install.sh --verbose

# Ver todos los flags disponibles
./install.sh --help

Verificar instalación

gentle-ai --version

Engram — Memoria persistente

Engram es el sistema de memoria de gentle-ai. Guarda contexto entre sesiones para que tu agente recuerde tu proyecto, decisiones de arquitectura, preferencias de código y conversaciones previas.

Qué recuerda

• Stack tecnológico y versiones del proyecto
• Convenciones de código y estilo
• Decisiones de arquitectura y su justificación
• Errores comunes y sus soluciones
• Preferencias personales del desarrollador

Comandos de memoria

# Ver el contexto actual
gentle-ai memory show

# Agregar una entrada manual
gentle-ai memory add "Usamos pnpm, no npm"

# Sincronizar con el repositorio
gentle-ai memory sync

# Limpiar memoria obsoleta
gentle-ai memory prune

SDD — Spec-Driven Development

SDD es la metodología de desarrollo guiado por especificación de gentle-ai. Organiza el trabajo en 9 fases que llevan una idea desde el brief hasta el código con documentación generada en cada paso.

Las 9 fases

1. Brief — Descripción del problema a resolver
2. Spec de requerimientos — Qué debe hacer el sistema
3. Arquitectura — Cómo está estructurado
4. Interfaces — Contratos entre componentes
5. Implementación — Código guiado por las fases anteriores
6. Tests — Validación de cada componente
7. Review — Revisión con GGA
8. Documentación — Generada automáticamente
9. Deploy — Checklist de salida a producción

Iniciar un flujo SDD

/sdd-init

Skills — Patrones curados

Skills es la biblioteca de 21 patrones de código curados por Gentleman Programming. Cubre las tecnologías más utilizadas con las mejores prácticas actualizadas.

Skills disponibles

• React 19 — Componentes, hooks, Server Components
• Next.js 15 — App Router, Server Actions, Streaming
• TypeScript estricto — Types, generics, discriminated unions
• Tailwind 4 — Utilidades, variables CSS, dark mode
• Testing con Vitest y Testing Library
• Y 16 más...

Ver todos los skills

skill-registry

Context7 — Docs en tiempo real

Context7 es la integración MCP que permite a tu agente consultar la documentación oficial de cualquier librería en tiempo real, con la versión correcta.

Sin Context7, tu agente trabaja con datos de entrenamiento que pueden tener meses o años de antigüedad. Con Context7, siempre tiene la información actualizada.

GGA — Gentleman Guardian Angel

GGA es el sistema de code review automático de gentle-ai. Se ejecuta en cada commit y detecta problemas de calidad antes de que lleguen a main.

Qué revisa GGA

• Inconsistencias con las convenciones del proyecto
• Patrones considerados malos en el contexto de tu stack
• Deuda técnica acumulada
• Tests faltantes en código nuevo
• Violaciones de las reglas de accesibilidad

Configuración

# gentle-ai.config.json
{
  "gga": {
    "enabled": true,
    "severity": "warn",
    "skipPatterns": ["*.test.ts", "*.spec.ts"],
    "rules": {
      "no-any": "error",
      "require-tests": "warn"
    }
  }
}

Persona — El mentor

Persona define el comportamiento de tu agente: cómo se comunica, qué tan detallado es, cuándo enseña y cuándo solo ejecuta.

Con Persona activado, tu agente no solo resuelve problemas — explica las decisiones, propone alternativas y te ayuda a construir tu propio criterio técnico.

Modos disponibles

• mentor — Explica cada decisión, propone alternativas (default)
• executor — Ejecuta sin explicaciones, máxima velocidad
• reviewer — Solo revisa y sugiere, no implementa

# Cambiar modo de Persona
gentle-ai persona set mentor

# Ver modo actual
gentle-ai persona show

Agentes soportados

gentle-ai funciona con cualquier agente que soporte el estándar MCP o que permita configuración de contexto inicial.

Comandos

Referencia completa de los comandos disponibles en gentle-ai.

FAQ