Communitygithub.com

haidrrrry/loop-engineering-skills

El cerebro que le falta a los agentes de codificación de IA: compuertas de verificación escritas antes del código, memoria estilo Reflexion que aprende de cada fallo y bucles de autocorrección con anclajes reales. Instalación con un solo comando para Claude Code; indicaciones de copiar y pegar para cualquier IA.

¿Qué es loop-engineering-skills?

Loop Memory implementa un sistema de memoria verbal estilo Reflexion diseñado para agentes de codificación de IA como Claude Code, Cursor o Codex. En lugar de reintentar ciegamente, el agente reflexiona por escrito sobre cada intento, almacena esa reflexión en un archivo `.loop/LESSONS.md` y la consulta antes de actuar. Estudios (Shinn et al., 2023) demuestran que este mecanismo supera los reintentos ciegos en un +22% en tareas de decisión y +11% en código, y supera la memoria sin reflexión en 8 puntos. La habilidad incluye un protocolo claro: antes de cada tarea se leen las reglas permanentes y las 3 entradas más recientes; después de cada intento (éxito o fallo) se agrega una entrada estructurada con causa raíz y una instrucción verificable para la próxima vez. También incorpora mantenimiento automático: cuando el archivo supera las ~30 entradas, las lecciones repetidas se promocionan a reglas permanentes y las entradas antiguas se eliminan, evitando el crecimiento ilimitado y la "memoria muerta".

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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)

  1. Leer .loop/LESSONS.md.
  2. Aplicar la sección Reglas permanentes de forma incondicional.
  3. 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 deploy antes 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)

  1. Lee todas las entradas de la más antigua a la más reciente.
  2. Cualquier lección que aparezca 2+ veces se promociona a Reglas permanentes, reescrita como una sola línea imperativa.
  3. Elimina las 20 entradas más antiguas después de la promoción.
  4. 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.

Skills relacionados