Skip to main content
Decision Memory es la forma en que Kodus recuerda por qué un agente de IA realizó los cambios que hizo, no solo el diff, sino el razonamiento, las restricciones y las alternativas consideradas. Las decisiones se capturan automáticamente en cada turno del agente y se almacenan como archivos markdown estructurados versionados junto a tu código.

​
Por qué existe

La revisión de código detecta lo que está mal en un diff. No te dice por qué el autor eligió el enfoque A sobre el B, o qué restricción forzó la solución provisional fea en la línea 42. Para los agentes de IA, ese contexto desaparece entre sesiones: cada ejecución comienza desde cero. Decision Memory soluciona esto al:
  • Capturar el razonamiento automáticamente en cada evento de turno completado.
  • Almacenarlo en el repositorio para que el contexto viaje con el código, no con la sesión.
  • Clasificarlo por PR y por módulo para obtener tanto contexto a nivel de rama como conocimiento de módulo a largo plazo.

​
Cómo funciona

Cuando está habilitado, Kodus instala hooks en los eventos de turno completado de tu agente de IA. En cada turno, las decisiones del agente se capturan en:
  • La memoria de PR vive en la rama. Tiene ámbito al SHA head actual: a medida que la rama evoluciona, se crean nuevos archivos para cada estado significativo.
  • La memoria de módulo es a largo plazo. Acumula decisiones por módulo a lo largo del tiempo.
  • modules.yml le dice a Kodus cómo asignar rutas a módulos (p. ej., src/auth/** → módulo auth).

​
Agentes compatibles

  • Claude Code — mediante hook de configuración en stop/agent-turn-complete.
  • Cursor — mediante reglas del espacio de trabajo.
  • Codex — mediante entrada notify en ~/.codex/config.toml.

​
Configuración

Habilitar para todos los agentes detectados:
O apuntar a agentes específicos:
Si hay una configuración previa, forzar una reinstalación:
Verificar qué está configurado:

​
Flujo de trabajo

1

Habilitar los hooks

Esto instala archivos de integración específicos del agente y agrega .kody/ a git (creando un modules.yml si no existe).
2

Trabajar con normalidad

A medida que tú (o tu agente) trabajas, cada evento de turno completado captura una decisión en .kody/pr/by-sha/<sha>.md. Confirma estos archivos junto con tus cambios de código: el razonamiento ahora está bajo control de versiones.
3

Revisar las decisiones capturadas

4

Promover a memoria a largo plazo

Cuando se fusiona un PR, promueve sus decisiones a nivel de PR a la memoria de nivel de módulo para que persistan más allá de la rama:

​
Qué se captura

Cada archivo de decisión es markdown estructurado:
  • Resumen — lo que el agente pretendía hacer.
  • Contexto — restricciones, decisiones previas, archivos referenciados.
  • Alternativas consideradas — enfoques que el agente rechazó y por qué.
  • Resultado — lo que realmente se cambió.
La forma exacta depende del evento de turno del agente; el CLI lo normaliza en un formato consistente de encabezado + cuerpo.

​
Deshabilitar

Eliminar todos los hooks y archivos de integración:
Esto no elimina los datos en .kody/: tu historial permanece intacto. Elimina el directorio manualmente si quieres empezar desde cero.

​
Archivos de contexto que lee el CLI

Además de .kody/, el CLI recoge contexto del proyecto de estos archivos al ejecutar revisiones: Estos son ortogonales a Decision Memory: describen el contexto permanente, mientras que Decision Memory captura el razonamiento turno por turno.

​
Relacionado

Agentes de IA

Bucles de revisión y corrección con Claude Code, Cursor, Codex y Windsurf.

Conceptos

Kody Rules, configuración centralizada y modos de diff.

Referencia de Comandos

Listado completo de flags de kodus decisions.

Solución de Problemas

¿Los hooks de decisión no capturan? Consulta el acordeón dedicado.