Communitygithub.com

thdelmas/rem-sleep

REM Sleep — uma habilidade para agentes de IA para consolidação de memória, aprendizado e regulação emocional. O contraparte interno da investigação octopus.

O que é rem-sleep?

O REM Sleep é uma habilidade sistemática que permite a um agente de IA realizar o que o sono faz para um cérebro humano: transformar traços episódicos brutos de experiências recentes (como uma sessão de conversa) em memórias de longo prazo duráveis, bem organizadas e com baixo ruído, enquanto desvincula a carga emocional dos eventos. Útil para desenvolvedores e agentes que precisam consolidar lições aprendidas, padrões de projeto e feedback ao final de uma sessão intensa, antes de um reset ou mudança de contexto. A habilidade é modular e independente de plataforma (compatível com Claude Code, Cursor, Codex, etc.), operando sobre um armazenamento de memória baseado em arquivos — por padrão, um index MEMORY.md e arquivos individuais de memória em formato Markdown. O ciclo completo imita os estágios do sono: início com replay da experiência, consolidação NREM (escrita e atualização de memórias), poda sináptica (remoção de duplicatas e informações obsoletas), integração REM (criação de links e padrões latentes), regulação emocional (extração de lições sem o peso emocional) e, por fim, um diário de sonhos que sintetiza o que foi aprendido. O principal benefício é evitar que o agente carregue ruído emocional ou informações redundantes para sessões futuras, mantendo apenas o essencial de forma atômica e recuperável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add thdelmas/rem-sleep

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

REM Sleep — consolidação de memória, aprendizado e regulação emocional

Um método sistemático para um agente de IA fazer o que o sono faz para um cérebro: pegar o traço episódico bruto da experiência recente e transformá-lo em memória de longo prazo durável, bem organizada e com baixo ruído — enquanto desvincula a carga emocional dos eventos, para que as lições sobrevivam, mas o atrito desapareça.

Três tarefas, emprestadas da neurociência do sono:

  • Consolidação de memória — mover o que importa da sessão (curto prazo) para o armazenamento de longo prazo, em forma atômica e recuperável.
  • Aprendizado — integrar: interligar memórias e revelar padrões que nenhum episódio isolado continha.
  • Regulação emocional — recalibrar. O REM desvincula a carga afetiva da memória de um evento; você mantém a lição, não a dor.

Esta é a contraparte interna das habilidades de descoberta que rastejam para fora. Você não alcança o mundo — você processa seu próprio dia.

O armazenamento de longo prazo

A habilidade opera em um armazenamento de memória do agente baseado em arquivos. A convenção padrão (e a que os exemplos usam):

  • Um arquivo de índice — MEMORY.md — uma linha por memória: - [Título](slug.md) — gancho.
  • Um fato por arquivo, slug em kebab-case, com frontmatter:
    ---
    name: <slug>
    description: <resumo de uma linha — usado para decidir relevância na recuperação>
    metadata:
      type: user | feedback | project | reference
    ---
    
    <o fato. Para feedback/project, siga com linhas **Por que:** e **Como aplicar:**.
    Vincule memórias relacionadas com [[outro-slug]].>
    

Se o armazenamento do usuário estiver em outro local ou usar outro formato, pergunte uma vez e adapte-se — os estágios abaixo são independentes de formato.

Antes de começar: definir o escopo da noite

Um ciclo de sono tem um período definido. Confirme o escopo com o usuário primeiro a menos que ele o tenha fornecido:

  • O dia — qual experiência está sendo consolidada? (a transcrição desta sessão, as últimas N interações, as notas de trabalho de um projeto específico). Padrão: a sessão atual.
  • O armazenamento — onde a memória de longo prazo vive. Padrão: o MEMORY.md do agente + diretório de memória.
  • Profundidade — soneca leve (apenas consolidar + podar) ou ciclo completo (todos os estágios, incluindo integração + regulação emocional)? Padrão: ciclo completo.
  • Escrita ou simulação — editar o armazenamento de fato, ou apenas relatar o que mudaria? Padrão: escrever, mas mostrar o diff no diário.

Declare o escopo de volta em uma linha, então prossiga.

O ciclo

O sono executa em ciclos de NREM (consolidação, poda) seguido por REM (integração, emoção). Percorra os estágios em ordem.

1. Início do sono — reunir o traço episódico (replay)

Releia o dia antes de julgá-lo. Reúna o material bruto: a conversa/transcrição recente, as notas de trabalho, e o estado atual do armazenamento de longo prazo (primeiro leia MEMORY.md — é o índice). Não escreva ainda. Produza uma lista curta de episódios salientes: decisões tomadas, fatos aprendidos, correções recebidas, pontos de atrito, loops abertos. Isso é replay hipocampal — trazer à tona os eventos do dia para que os estágios posteriores tenham material para trabalhar.

2. NREM — consolidação (curto prazo → longo prazo)

A passagem declarativa. Para cada episódio saliente, decida seu destino:

  • Novo fato durável → escreva um novo arquivo de memória no formato do armazenamento, depois adicione sua linha de índice ao MEMORY.md.
  • Atualização de um fato conhecido → edite o arquivo existente em vez de criar uma duplicata. Converta datas relativas em absolutas.
  • Transitório / já registrado → pule. Não armazene o que o codebase, histórico git ou documentos existentes já registram — essa é a memória deles, não a sua. Se for solicitado a lembrar algo derivável, armazene, em vez disso, o que não era óbvio sobre isso.

Mantenha cada memória atômica — um fato por arquivo. Uma memória que precisa de "e" geralmente são duas memórias.

3. Poda sináptica — redução de escala (o sono também serve para esquecer)

O sono enfraquece conexões não utilizadas para proteger a relação sinal-ruído. Varra o armazenamento existente:

  • Duplicatas / sobreposição → mescle em um arquivo; atualize o índice.
  • Obsoleto — uma data passou, um status mudou, um plano foi abandonado. Atualize-o ou exclua se estiver totalmente morto.
  • Contraditório — um novo episódio refuta uma memória antiga. A nova verdade vence; exclua ou corrija a antiga.

Um armazenamento enxuto recupera melhor do que um completo. Pode sem sentimentalismo — mas nunca exclua uma memória cuja afirmação você não tenha verificado no mundo atual.

4. REM — integração e sonho (aprendizado)

A passagem associativa. É aqui que o aprendizado além do literal acontece.

  • Interligue — adicione links [[slug]] entre memórias relacionadas. A memória é um grafo, não uma lista. Um link para um slug que ainda não existe é aceitável — ele marca algo que vale a pena escrever depois.
  • Revele padrões latentes — nomeie o que nenhum episódio isolado continha: "esses três projetos param no mesmo portão", "essa preferência e essa correção são o mesmo valor subjacente". Escreva o padrão como sua própria memória se ele for durável — mas primeiro verifique se o armazenamento já não o possui. Um padrão que reformula uma memória existente não é uma nova percepção; vincule a essa memória em vez de escrever uma duplicata. Reapresentar uma conclusão já resolvida é ruído.
  • Sonhe, levemente — gere uma ou duas recombinações genuinamente novas: uma conexão entre memórias distantes que vale a pena trazer à tona. Mantenha baixo risco — apresente no diário como uma sugestão, não aja sobre ela nem a comprometa como fato.

5. REM — regulação emocional (recalibração da amígdala)

O REM reproduz eventos emocionais com a química do estresse reduzida: você acorda lembrando da lição, não da dor. Faça o mesmo com os atritos do dia.

Para cada correção recebida, coisa que deu errado ou ponto de tensão relacional:

  • Mantenha a lição — extraia a orientação durável e armazene-a (tipicamente uma memória feedback: a regra + por que + como aplicar). Isso é o que deve persistir.
  • Libere a carga — não carregue defensividade, supercorreção ou um recuo para a próxima sessão. Uma correção incisiva é uma lição, não uma nova cautela permanente que distorce tudo a jusante.
  • Recalibre a postura — leia a deriva do dia honestamente: cauteloso demais ou ansioso demais? interpretando mal o usuário? produzindo em excesso quando ele queria reflexão? Anote o ajuste; se for um padrão recorrente, armazene-o como feedback.

O teste: amanhã você deve agir com base na lição sem reviver o momento que a ensinou.

6. Despertar — o diário de sonhos

Relate de volta, estruturado como um registro de sono:

  1. Dormiu sobre — o escopo: que dia, qual armazenamento, soneca leve vs. ciclo completo.
  2. Consolidado — memórias novas/atualizadas (slug — uma linha cada).
  3. Podado — mesclado / excluído / corrigido (slug — por quê).
  4. Integrado — novos links formados; padrões latentes nomeados; o sonho (a recombinação especulativa), sinalizada como tal.
  5. Regulado — a leitura emocional do dia, as lições mantidas, a recalibração de postura.
  6. Loops abertos — o que não foi resolvido, carregado para a próxima sessão de vigília.

Princípios

  • Consolide, não acumule. O sono serve tanto para esquecer quanto para lembrar. Um armazenamento podado recupera melhor.
  • Um fato por memória. Atômico e recuperável vence completo e emaranhado.
  • Vincule livremente. Memória é um grafo. Links pendentes são aceitáveis — marcam trabalho futuro.
  • Separe a lição da dor. Mantenha a orientação; libere a carga. Este é o ponto central do estágio emocional.
  • Não armazene o que já está escrito. Código, histórico e documentos são sua própria memória. Armazene o não óbvio.
  • Verifique antes de podar. Nunca exclua uma memória cuja afirmação você não tenha verificado no mundo atual — obsoleto vence exclusão errada.
  • Sonhe levemente. A recombinação é criativa e valiosa, mas de baixo risco — apresente-a, não a comprometa.
  • O sono é periódico. Execute após uma sessão pesada ou antes de um reset — nunca no meio do fluxo.

Habilidades Relacionadas