thdelmas/rem-sleep

REM Sleep — consolidación de memoria, aprendizaje y regulación emocional

Un método sistemático para que un agente de IA haga lo que el sueño hace por un cerebro: tomar el rastro episódico crudo de la experiencia reciente y convertirlo en memoria a largo plazo duradera, bien organizada y de bajo ruido — mientras se separa la carga emocional de los eventos para que las lecciones sobrevivan pero el roce desaparezca.

Tres tareas, tomadas de la neurociencia del sueño:

• Consolidación de memoria — mover lo que importa de la sesión (corto plazo) al almacén a largo plazo, en forma atómica y recuperable.
• Aprendizaje — integrar: enlazar memorias entre sí, y sacar a la superficie patrones que ningún episodio contenía por sí solo.
• Regulación emocional — recalibrar. El sueño REM separa la carga afectiva de la memoria de un evento; te quedas con la lección, no con el aguijón.

Esta es la contraparte interna de las habilidades de descubrimiento que se extienden hacia afuera. No te adentras en el mundo — procesas tu propio día.

El almacén a largo plazo

El skill opera sobre un almacén de memoria de agente basado en archivos. La convención por defecto (y la que usan los ejemplos):

• Un archivo índice — MEMORY.md — una línea por memoria: - [Título](slug.md) — gancho.
• Un hecho por archivo, slug en kebab-case, con frontmatter:

  ---
  name: <slug>
  description: <resumen de una línea — usado para decidir relevancia al recuperar>
  metadata:
    type: user | feedback | project | reference
  ---
  
  <el hecho. Para feedback/project, seguir con líneas de **Por qué:** y **Cómo aplicar:**.
  Enlazar memorias relacionadas con [[otro-slug]].>
  

Si el almacén del usuario reside en otro lugar o usa otro formato, pregunta una vez y adáptate — las etapas siguientes son independientes del formato.

Antes de empezar: delimitar la noche

Un ciclo de sueño tiene un alcance definido. Confirma el alcance con el usuario primero a menos que ya lo haya dado:

• El día — ¿qué experiencia se va a consolidar? (la transcripción de esta sesión, los últimos N turnos, las notas de trabajo de un proyecto específico). Por defecto: la sesión actual.
• El almacén — dónde vive la memoria a largo plazo. Por defecto: MEMORY.md del agente + el directorio de memoria.
• Profundidad — siesta ligera (solo consolidar y podar) o ciclo completo (todas las etapas incluyendo integración y regulación emocional). Por defecto: ciclo completo.
• Escribir o simular — editar el almacén realmente, o solo informar lo que cambiaría. Por defecto: escribir, pero mostrar el diff en el diario.

Declara el alcance en una línea, luego procede.

El ciclo

El sueño se ejecuta en ciclos de NREM (consolidación, poda) y luego REM (integración, emocional). Recorre las etapas en orden.

1. Inicio del sueño — recopilar el rastro episódico (repetición)

Vuelve a leer el día antes de juzgarlo. Toma el material bruto: la conversación/transcripción reciente, las notas de trabajo provisionales y el estado actual del almacén a largo plazo (lee MEMORY.md primero — es el índice). No escribas todavía. Produce una lista corta de episodios salientes: decisiones tomadas, hechos aprendidos, correcciones recibidas, puntos de fricción, bucles abiertos. Esto es repetición hipocampal — saca a la superficie los eventos del día para que las etapas posteriores tengan algo sobre lo que trabajar.

2. NREM — consolidación (corto plazo → largo plazo)

El pase declarativo. Para cada episodio saliente, decide su destino:

• Nuevo hecho duradero → escribe un nuevo archivo de memoria en el formato del almacén, luego añade su línea de índice a MEMORY.md.
• Actualización de un hecho conocido → edita el archivo existente en lugar de crear un duplicado. Convierte fechas relativas a absolutas.
• Transitorio / ya registrado → omítelo. No almacenes lo que el codebase, el historial de git o los documentos existentes ya registran — esa es su memoria, no la tuya. Si te piden recordar algo que se puede derivar, almacena en cambio lo que no era obvio al respecto.

Mantén cada memoria atómica — un hecho por archivo. Una memoria que necesita "y" suele ser dos memorias.

3. Escalado sináptico — poda (dormir también es para olvidar)

El sueño debilita las conexiones no utilizadas para proteger la relación señal/ruido. Revisa el almacén existente:

• Duplicados / superposición → fusiona en un solo archivo; actualiza el índice.
• Obsoleto — una fecha ha pasado, un estado ha cambiado, un plan fue abandonado. Actualízalo, o bórralo si está completamente muerto.
• Contradicho — un nuevo episodio refuta una memoria antigua. La nueva verdad gana; borra o corrige la antigua.

Un almacén esbelto recuerda mejor que uno completo. Poda sin sentimentalismo — pero nunca borres una memoria cuya afirmación no hayas verificado realmente contra el mundo actual.

4. REM — integración y ensoñación (aprendizaje)

El pase asociativo. Aquí es donde ocurre el aprendizaje más allá de lo literal.

• Enlazar — añade enlaces [[slug]] entre memorias relacionadas. La memoria es un grafo, no una lista. Un enlace a un slug que aún no existe está bien — marca algo que vale la pena escribir más tarde.
• Sacar a la superficie patrones latentes — nombra lo que ningún episodio contenía por sí solo: "estos tres proyectos se estancan en la misma puerta", "esta preferencia y aquella corrección son el mismo valor subyacente". Escribe el patrón como su propia memoria si es duradero — pero primero verifica que el almacén no lo tenga ya. Un patrón que reformula una memoria existente no es una nueva idea; enlaza a esa memoria en lugar de escribir un duplicado. Volver a sacar a la superficie una conclusión ya establecida es ruido.
• Soñar, ligeramente — genera una o dos recombinaciones genuinamente novedosas: una conexión entre memorias distantes que vale la pena sacar a la superficie. Mantenlo de bajo riesgo — publícalo en el diario como una sugerencia, no actúes sobre él ni lo registres como un hecho.

5. REM — regulación emocional (recalibración de la amígdala)

El sueño REM reproduce eventos emocionales con la química del estrés reducida: despiertas recordando la lección, no el aguijón. Haz lo mismo con la fricción del día.

Para cada corrección recibida, cosa que salió mal o punto de tensión relacional:

• Conserva la lección — extrae la guía duradera y almacénala (típicamente una memoria de tipo feedback: la regla + por qué + cómo aplicar). Esto es lo que debe persistir.
• Libera la carga — no lleves a la siguiente sesión la actitud defensiva, la sobrecorrección o un sobresalto. Una corrección aguda es una lección, no una nueva precaución permanente que distorsione todo lo posterior.
• Recalibra la postura — lee honestamente la deriva del día: ¿demasiado cauteloso o demasiado ansioso? ¿interpretando mal al usuario? ¿produciendo en exceso cuando querían reflexión? Anota el ajuste; si es un patrón recurrente, almacénalo como feedback.

La prueba: mañana deberías actuar según la lección sin revivir el momento que la enseñó.

6. Despertar — el diario de sueños

Informa de vuelta, estructurado como un registro de sueño:

1. Dormido sobre — el alcance: qué día, qué almacén, siesta ligera vs. ciclo completo.
2. Consolidado — memorias nuevas/actualizadas (slug — una línea cada una).
3. Podado — fusionado / borrado / corregido (slug — por qué).
4. Integrado — nuevos enlaces formados; patrones latentes nombrados; el sueño (la recombinación especulativa), marcado como tal.
5. Regulado — la lectura emocional del día, las lecciones conservadas, la recalibración de la postura.
6. Bucles abiertos — lo que no está resuelto, llevado a la siguiente sesión de vigilia.

Principios

• Consolida, no acumules. Dormir es tanto para olvidar como para recordar. Un almacén podado recuerda mejor.
• Un hecho por memoria. Atómico y recuperable vence a completo y enredado.
• Enlaza libremente. La memoria es un grafo. Los enlaces colgantes están bien — marcan trabajo futuro.
• Separa la lección del aguijón. Conserva la guía; libera la carga. Este es el objetivo principal de la etapa emocional.
• No almacenes lo que ya está escrito. El código, el historial y los documentos son su propia memoria. Almacena lo no obvio.
• Verifica antes de podar. Nunca borres una memoria cuya afirmación no hayas verificado contra el mundo actual — lo obsoleto vence a la eliminación errónea.
• Sueña ligeramente. La recombinación es creativa y valiosa, pero de bajo riesgo — sácala a la superficie, no la confirmes.
• El sueño es periódico. Ejecútalo después de una sesión pesada o antes de un reinicio — no a mitad del flujo.