Caso de estudio Engram

Darle memoria a los
asistentes de código.

Un engrama es la huella que deja un recuerdo. Esta guarda las decisiones, las lecciones y el razonamiento de un proyecto, y le entrega al asistente solo la parte que importa ahora — para que la próxima sesión no empiece desde cero.

Qué fue
Un estudio, para responder una pregunta
Dónde está
Prototipo funcional, medido
Qué sigue
Convertirse en producto alojado

01 / El problema

Todo lo que la sesión anterior olvidó.

Los asistentes de IA se volvieron muy buenos escribiendo código y siguen siendo pésimos recordando por qué. Cada sesión arranca desde cero. El razonamiento detrás del arreglo de la semana pasada vive en un chat que nadie puede buscar, y el desarrollador vuelve a explicar el mismo proyecto todas las mañanas.

  • Explicarlo todo otra vez
  • Desviarse de la tarea
  • Código que nadie entiende
  • Nada compartido entre repos
  • Decisiones extraviadas
  • Incorporación desde cero

Seis cosas que un desarrollador pierde entre el viernes y el lunes.

Solo lo relevante

El asistente recibe lo que toca esta tarea, no un volcado del proyecto entero.

Sobrevive a la sesión

Planes, decisiones y lecciones se guardan mientras trabajas. Retomas días después con todo el contexto.

Compartida por el equipo

Un solo repositorio donde todos escriben y leen, para que el conocimiento se acumule en vez de dispersarse.

02 / La prueba

El mismo error, dos caminos.

La pregunta que el estudio venía a responder: ¿una memoria real reduce el trabajo, o solo lo mueve de lugar? Así que corrí la misma tarea de las dos formas — armando el contexto del asistente a mano, y después dejando que se recuperara solo. Son mediciones del prototipo sobre mis propios proyectos, no un benchmark.

El mismo error, dos caminos

A mano

Tú armas el contexto

0palabras de contexto

  • historial del bug pegado del chat
  • tres archivos completos, por si acaso
  • «¿te acuerdas cuando…?» de memoria
  • un documento de decisión, quizá obsoleto
  • el arreglo anterior, a medio recordar
  • salida de tests, sin filtrar

Fácil pasar por alto el caso límite enterrado en un arreglo anterior.

Con Engram

Describes la tarea en una línea

0palabras de contexto

  • engram start "arreglar carrera en el checkout"
  • engram find "reintentos de pago"

Devuelve

  • el archivo y las líneas exactas que lo manejan
  • la lección: los reintentos no deben cobrar dos veces
  • la decisión, y por qué se tomó así

La lección pertinente, el plan anterior, las zonas de riesgo y el código que importa — reunidos solos, listos para trabajar.

Alrededor de la mitad del contexto, y mucho menos tecleo. El resultado más útil fue el de segundo orden: lo que recibe el asistente deja de depender de lo que el desarrollador alcanzó a recordar esa mañana.

Entendimiento, verificado en tres momentos

La velocidad solo vale la pena si alguien todavía entiende el resultado. El estudio integró las verificaciones en el flujo de trabajo en vez de dejarlas a la buena voluntad — baratas en cambios rutinarios, exhaustivas donde el riesgo es real.

  1. 01

    Cuando el código llega

    El asistente lee el proyecto y registra qué se ve frágil, sin dueño o de alcance amplio. Ese mapa se guarda una vez, así todos los que vienen después lo heredan en lugar de descubrirlo rompiendo algo.

  2. 02

    Cuando empieza el trabajo

    Cada tarea recibe orientación proporcional al riesgo real del cambio. Lo pequeño se mantiene liviano; lo que toca una zona sensible recibe el informe completo.

  3. 03

    Cuando el trabajo termina

    El cambio terminado se revisa contra lo que efectivamente se entendió de él, y el veredicto no se puede dejar pasar si tocó algo crítico.

03 / Aprendizaje

El repositorio se depura solo.

Una memoria que solo crece termina siendo un cajón de sastre. La parte interesante del estudio fue lograr que se podara sola: lo que sigue siendo útil aparece más seguido, lo que no se hunde en silencio, y nadie tiene que mantenerlo a mano.

  1. 01

    Recuperar

    Una tarea trae las notas y el código que necesita, y queda registrado qué se usó.

  2. 02

    Observar

    Al terminar el trabajo, la revisión dice si realmente salió bien.

  3. 03

    Atribuir

    Ese veredicto se devuelve a las notas concretas que se usaron.

  4. 04

    Ordenar

    La próxima vez, las notas que ayudaron vuelven primero. El ciclo se cierra.

Deliberadamente conservador: una mala ejecución no puede enterrar una buena nota, y lo que una persona confirmó explícitamente queda protegido de cualquier descenso.

04 / Cómo funciona

Muchos asistentes, una sola memoria.

Los equipos no usan todos las mismas herramientas, y las herramientas cambian cada pocos meses. Por eso la memoria vive fuera de ellas: todos los asistentes leen y escriben en el mismo repositorio, así cambiar de herramienta no cuesta nada y el conocimiento de nadie queda atrapado en un proveedor.

  • Claude Code
  • Cursor
  • Codex CLI
  • Copilot
  • Windsurf
  • y otros

Asistentes

Personas e IA, tratados igual

Ambos hacen las mismas preguntas y reciben las mismas respuestas.

El repositorio

El conocimiento del proyecto, en un solo lugar

  • el código en sí
  • decisiones y su porqué
  • lecciones aprendidas
  • revisiones y riesgos
  • reglas y restricciones
  • planes en curso

Busca de tres formas a la vez — por significado, por redacción y por nombre exacto — y después combina los resultados. La respuesta llega como una referencia precisa, así el asistente abre el archivo correcto en las líneas correctas en lugar de adivinar.

Para quien tenga curiosidad técnica

División
El código se divide siguiendo su estructura real — funciones y clases, no bloques arbitrarios — para que un fragmento recuperado siempre sea algo completo. La prosa se divide por sus encabezados.
Dos vocabularios
Código y prosa se indexan con modelos distintos, porque la forma de preguntar que encuentra un documento de diseño no es la que encuentra una función.
Búsqueda
Búsqueda por significado, por palabra clave y por símbolo exacto corren juntas y sus rankings se combinan. Buscar el nombre pelado de una función va directo a la coincidencia exacta.
Entre repositorios
El trabajo que abarca varios repositorios se enlaza como un solo esfuerzo, para que los cambios relacionados aparezcan a propósito — sin filtraciones accidentales entre proyectos que no tienen relación.
Dónde vive
Corre sobre tu propia base de datos, autoalojada o gestionada. El conocimiento se queda donde tú controlas.

05 / Qué sigue

De estudio a producto.

El estudio respondió su pregunta: una memoria de proyecto cambia cómo trabaja un equipo con IA, y el efecto crece con el tamaño del código. El siguiente paso es que sea algo que un equipo pueda encender en vez de construir — una versión alojada, en preparación.

Si tu equipo entrega rápido con IA y va perdiendo el razonamiento detrás, me gustaría saber cómo. Las conversaciones tempranas definen qué se construye primero.