Memoria en Bucle
Memoria estilo Reflexion: el agente reflexiona por escrito sobre cada intento, almacena la reflexión y lee las reflexiones recientes antes de actuar. La investigación (Shinn et al., 2023) muestra que este mecanismo — reflexionar, almacenar, releer — supera los reintentos ciegos por márgenes amplios (+22% en tareas de decisión sobre 12 pruebas, +11% en código) y supera la memoria sin reflexión en 8 puntos. La ganancia proviene de las razones escritas, no de reintentar con más ahínco.
El protocolo
Antes de actuar (cada tarea)
- Leer
.loop/LESSONS.md. - Aplicar la sección Reglas permanentes de forma incondicional.
- Leer las 3 entradas más recientes. Si alguna es relevante para la tarea actual, indica en una línea cómo cambia tu enfoque. Si ninguna es relevante, continúa — no lo fuerces.
Después de actuar (cada intento, éxito o fracaso)
Agrega exactamente una entrada con el formato del archivo:
## [fecha] — [tarea, 5 palabras máx.] — ÉXITO|FRACASO
- Qué ocurrió: [una línea]
- Causa raíz / por qué funcionó: [una línea]
- Próxima vez: [una instrucción específica y verificable]
Estándar de calidad para "Próxima vez":
- ❌ "Ten más cuidado con la base de datos" — no verificable
- ✅ "Ejecuta
npx prisma migrate deployantes de cualquier script de siembra" — verificable - ❌ "Recuerda que la API es complicada" — vago
- ✅ "El endpoint /users pagina en 50; siempre pasa ?page= al contar"
Reflexión de fracaso, específicamente
Cuando un intento falló, la reflexión debe responder: ¿qué creía que estaba mal? Los intentos fallidos generalmente provienen de una suposición falsa, no de un error tipográfico. Nombra la suposición. Esa es la lección.
Mantenimiento (cuando el archivo supera las ~30 entradas)
- Lee todas las entradas de la más antigua a la más reciente.
- Cualquier lección que aparezca 2+ veces se promociona a Reglas permanentes, reescrita como una sola línea imperativa.
- Elimina las 20 entradas más antiguas después de la promoción.
- Nunca elimines las Reglas permanentes sin la aprobación del usuario.
Qué NO almacenar
- Secretos, claves, tokens, datos personales — nunca, incluso si causaron el fallo.
- Narración ("Luego intenté X, después de lo cual Y…") — almacena solo conclusiones.
- Lecciones duplicadas — si ya está allí, no la vuelvas a agregar; considera promocionarla.
- Culpa o autocrítica — las lecciones son instrucciones, no sentimientos.
Modos de fallo a evitar
- Teatro de memoria: escribir entradas pero nunca leerlas. El paso de lectura es el valor; el paso de escritura solo es un diario.
- Sobreajuste a un incidente: un contratiempo puntual del entorno no es una lección. Si no puede repetirse, no lo registres.
- Crecimiento ilimitado: un archivo de 200 entradas que nadie lee es memoria muerta. Compresa.