remember

Visão geral do remember skill

O que o remember faz

O remember skill é uma skill focada de Knowledge Capture para salvar explicitamente fatos, convenções, decisões e pegadinhas na memória automática do Claude quando são importantes demais para depender apenas da captura automática. Ele foi feito para momentos como “finalmente encontramos o problema do CI”, “este projeto tem uma convenção não documentada” ou “o Claude não pode esquecer esta preferência da equipe”.

Em vez de pedir ao assistente para “guardar isso” e torcer para que a informação persista, remember dá ao agente um fluxo repetível: interpretar o conhecimento, verificar duplicidades e registrar uma entrada de memória contextual com timestamp.

Usuários e equipes para quem faz mais sentido

Use o remember skill se você trabalha em projetos de longa duração nos quais contexto recorrente importa: equipes de engenharia, desenvolvedores solo com vários repositórios, fluxos de depuração assistidos por IA ou agentes que precisam melhorar com o tempo. Ele é especialmente útil quando conhecimento importante fica no histórico do chat, mas ainda não está em CLAUDE.md, na documentação, em testes ou em comentários no código.

A skill não é uma base de conhecimento completa, um app de anotações nem um gerador de documentação. A função dela é mais específica: preservar memórias compactas e acionáveis que devem influenciar futuras sessões do Claude.

Por que isso é diferente de um prompt comum

Um prompt comum como “remember this” é ambíguo. O remember skill adiciona disciplina operacional: ele pergunta o que deve ser lembrado, por que isso importa e se a memória é específica do projeto ou global. Também inclui uma etapa de verificação de duplicidade para que o arquivo de memória não fique poluído com versões repetidas do mesmo fato.

Isso torna remember valioso quando o custo de esquecer é alto: depuração repetida, escolhas erradas de ferramenta, convenções de código ignoradas ou deriva de preferências ao longo do tempo.

Como usar o remember skill

Instalação do remember e revisão do código-fonte

Instale a skill a partir do repositório com seu gerenciador de skills, por exemplo:

npx skills add alirezarezvani/claude-skills --skill remember

Depois, inspecione o código-fonte em:

engineering-team/self-improving-agent/skills/remember/SKILL.md

Esta skill é compacta e não tem diretórios separados de scripts/, references/, rules/ ou resources/ na prévia do repositório, então SKILL.md é o arquivo principal a ser lido. Preste atenção aos exemplos de uso, ao comando de verificação de duplicidade e ao fluxo de criação de entradas de memória antes de depender dela em uma configuração de agente em produção.

Uso básico do remember

Chame a skill com /si:remember seguido exatamente do conhecimento que você quer salvar:

/si:remember "This project's CI requires Node 20 LTS — v22 breaks the build"

Boas entradas são específicas, duráveis e acionáveis. Uma entrada fraca seria:

/si:remember "CI is weird"

Uma entrada forte seria:

/si:remember "CI fails on Node 22 because the build image expects Node 20 LTS; use Node 20 for local reproduction and GitHub Actions parity"

A versão mais forte diz ao Claude futuro o que aconteceu, onde isso se aplica e qual ação tomar.

O que incluir no prompt

Para obter melhores resultados, inclua quatro informações:

• Fato: aquilo que o Claude deve reter.
• Contexto: onde isso se aplica, como um repo, endpoint, suíte de testes, ferramenta ou equipe.
• Motivo: por que esquecer isso leva a uma resposta ruim.
• Escopo: se é algo específico do projeto ou uma preferência geral.

Exemplo:

/si:remember "Project-specific: In this repo, API auth uses a custom JWT library instead of passport. Do not recommend passport middleware unless we are replacing the auth layer."

Isso dá à skill material suficiente para criar uma memória útil depois, não apenas uma anotação vaga.

Fluxo prático de Knowledge Capture

Use remember imediatamente depois de uma descoberta, decisão ou correção. O melhor momento é quando a informação ainda está fresca e antes de a conversa seguir para outro assunto.

Um fluxo prático:

1. Descubra um fato durável durante depuração, revisão ou planejamento.
2. Converta esse fato em uma frase com contexto e consequência.
3. Execute /si:remember "<fact>".
4. Deixe a skill verificar se já existe uma memória duplicada.
5. Se houver uma entrada parecida, atualize ou esclareça em vez de adicionar ruído.
6. Continue o trabalho com a nova memória disponível para sessões futuras.

Esse fluxo mantém a memória útil sem transformá-la em uma transcrição.

FAQ do remember skill

Quando devo usar o remember?

Use remember quando o conhecimento provavelmente afetará trabalhos futuros e ainda não estiver óbvio no código-base ou na documentação. Bons candidatos incluem requisitos de build, restrições de framework, decisões arquiteturais, problemas recorrentes em testes, convenções não documentadas e preferências estáveis de usuários ou equipes.

Não use para estado temporário de tarefa, como “estou editando o arquivo X agora”, a menos que esse fato ainda importe depois que a sessão terminar.

O remember é adequado para iniciantes?

Sim, porque o comando é simples, mas iniciantes devem tomar cuidado para não armazenar notas vagas ou emocionais. Uma memória como “o banco de dados é irritante” não ajuda. Uma memória como “Local DB tests require Docker Compose service postgres-test to be running before npm test” é útil.

A skill funciona melhor quando o usuário consegue descrever claramente a lição operacional.

Como o remember se compara ao CLAUDE.md?

CLAUDE.md é melhor para instruções estáveis e compartilhadas do projeto que todo agente futuro deve ler como parte do repo. remember é melhor para aprendizado incremental, descobertas difíceis e contexto que talvez ainda não esteja pronto para documentação formal.

Um bom padrão é usar remember primeiro e depois promover memórias repetidas ou relevantes para toda a equipe para CLAUDE.md, arquivos README, testes ou documentação de arquitetura.

Quando não devo usar o remember?

Não use remember para segredos, credenciais, tokens privados ou informações pessoais sensíveis. Não use como substituto de documentação versionada quando o conhecimento deveria estar visível para toda a equipe. Evite também salvar palpites, teorias não resolvidas ou observações pontuais, a menos que você as marque claramente como incertas.

A memória deve reduzir erros futuros, não preservar especulação.

Como melhorar o remember skill

Melhore os resultados do remember com entradas mais precisas

A maior alavanca de qualidade é a frase de entrada. Antes de chamar remember, reescreva descobertas brutas como orientação durável.

Bruto:

/si:remember "Jest hangs sometimes"

Melhor:

/si:remember "Project-specific: Jest integration tests can hang after DB tests unless run with --forceExit; use this flag when reproducing CI test hangs locally."

Esta versão nomeia a ferramenta, a condição, o contorno e o escopo. Isso torna a memória salva mais fácil de ser aplicada corretamente pelo Claude.

Evite memórias duplicadas e desatualizadas

O fluxo upstream inclui uma verificação de duplicidade contra o arquivo de memória do projeto. Respeite essa etapa. Memórias duplicadas criam orientações conflitantes, especialmente quando uma convenção muda ao longo do tempo.

Se você encontrar uma entrada antiga, prefira revisar conceitualmente a memória: “This replaces the old Node 18 note; the project now standardizes on Node 20 LTS.” Uma substituição clara é melhor do que acumular fatos contraditórios.

Transforme memórias recorrentes em documentação

Se o mesmo fato lembrado afeta vários contribuidores, tire-o da memória e leve-o para a documentação. Adicione-o a CLAUDE.md, README.md, documentos de onboarding, notas de setup de testes ou registros de decisão arquitetural. remember é excelente para captura, mas documentação versionada é melhor para governança compartilhada.

Uma regra útil: se o Claude precisou da memória mais de duas vezes, provavelmente humanos também precisam dela.

Modos comuns de falha a observar

Os principais modos de falha são salvar demais, definir escopo de menos e registrar conclusões sem evidência. Evite entradas amplas demais, como “always use explicit error handling”, a menos que isso seja de fato uma preferência global. Prefira orientação com escopo: “In this repo, avoid catch-all error handlers in API routes because errors are logged by middleware.”

Um bom uso de remember cria memórias compactas e contextuais que melhoram a assistência futura sem deixar o agente rígido ou ruidoso.