review

Visão geral da skill review

O que review faz

review é uma skill de self-improving-agent para auditar a auto-memory do Claude Code. Ela ajuda um agente a inspecionar MEMORY.md, encontrar candidatos à promoção, identificar entradas obsoletas ou duplicadas e gerar recomendações de manutenção, em vez de deixar a memória do projeto crescer sem controle. Use a skill review quando quiser entender o que o agente aprendeu, o que deve virar orientação durável do projeto e o que deve ser removido.

Melhor cenário de uso para esta skill review

Esta skill é mais útil para equipes que usam a memória do Claude Code como parte de um fluxo de Context Engineering. Ela combina com projetos em que aprendizados recorrentes, preferências de ferramentas, decisões arquiteturais ou erros repetidos são capturados automaticamente, mas precisam de revisão editorial periódica. Ela é menos útil se o seu projeto não usa memória do Claude Code, não tem um diretório de memória de projeto .claude ou precisa apenas de um resumo pontual de um arquivo-fonte.

O que a diferencia de um prompt genérico

Um prompt genérico do tipo “resuma minha memória” normalmente deixa passar verificações operacionais. A skill review dá ao agente um caminho de auditoria concreto: localizar o diretório de memória específico do projeto, ler MEMORY.md, verificar a pressão de contagem de linhas em relação ao limite de 200 linhas na inicialização, detectar recorrência, validar referências obsoletas a arquivos e separar candidatos à promoção de entradas de baixo valor. Essa estrutura torna a saída mais acionável para manter o contexto de agentes em projetos de longa duração.

Como usar a skill review

Instalação de review e primeiros arquivos para inspecionar

Instale a skill a partir do repositório do GitHub com:

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

Depois da instalação, leia SKILL.md primeiro. Este caminho do repositório contém o fluxo completo em um único arquivo, sem rules/, resources/, references/ ou scripts extras para inspecionar. As seções-fonte mais importantes são Usage, What It Does, Step 1: Locate memory directory e Step 2: Read and analyze MEMORY.md.

Comandos básicos de uso de review

A skill upstream foi desenhada em torno de invocações no estilo /si:review:

• /si:review para uma auditoria completa da memória
• /si:review --quick para contagens e principais candidatos
• /si:review --stale para focar em entradas desatualizadas
• /si:review --candidates para mostrar apenas prováveis promoções

Na prática, chame a skill review a partir da raiz do projeto que você quer auditar. A skill espera ter acesso à memória de projeto do Claude Code, normalmente em um caminho derivado do diretório de trabalho atual dentro de ~/.claude/projects/.../memory.

Entradas que melhoram a saída de review

Um prompt fraco seria: “Revise a memória.”

Um prompt mais forte seria:

“Run the review skill for this repository. Check the project auto-memory, count MEMORY.md lines against the startup limit, identify recurring lessons that should be promoted into durable instructions, flag stale entries that reference deleted files or old tools, and group recommendations by promote, consolidate, prune, and keep.”

Isso funciona melhor porque explicita os critérios de auditoria e os grupos de decisão. Se você souber de mudanças recentes no projeto, inclua esses detalhes: diretórios renomeados, ferramentas removidas, novos padrões de código ou mudanças de política. Essas informações ajudam o agente a julgar se uma entrada de memória está obsoleta ou ainda é valiosa.

Fluxo de trabalho sugerido para review

Comece com /si:review --quick se o arquivo de memória for grande ou se você só precisar de uma triagem. Execute a revisão completa ao preparar uma atualização de contexto, configurar o onboarding de um novo agente ou limpar memória acumulada antes de um ciclo importante de features. Use --stale depois de grandes refatorações, mudanças de dependência ou movimentações de arquivos. Use --candidates quando seu objetivo for Context Engineering: promover aprendizados repetidos para CLAUDE.md, documentação do projeto ou regras da equipe.

FAQ da skill review

review serve apenas para memória do Claude Code?

Sim. A skill foi especificamente moldada em torno das convenções de auto-memory do Claude Code, especialmente a memória de projeto em ~/.claude/projects/.../memory e MEMORY.md. Você pode adaptar o guia de review para outros arquivos de memória, mas o maior valor aparece quando o agente consegue seguir o layout esperado da memória do Claude Code.

O que acontece se não existir um diretório de memória?

A skill deve informar que a auto-memory pode estar desativada ou indisponível e sugerir a verificação da configuração de memória, por exemplo usando /memory. Esse é um ponto útil antes da instalação: se sua equipe ainda não ativou ou acumulou memória do Claude Code, review terá pouco a analisar até que essa memória exista.

Quando não devo usar review?

Não use review como substituto de code review, revisão de segurança ou QA de documentação. Ela audita a qualidade da memória do agente, não a correção do código-fonte. Também é uma escolha ruim para projetos recém-criados sem padrões recorrentes, equipes que evitam deliberadamente memória persistente de agentes ou situações em que você só precisa de um resumo simples de um único documento.

Como review ajuda em Context Engineering?

Em Context Engineering, review transforma memória bruta em uma fila de manutenção. Ela ajuda a decidir quais observações repetidas devem virar contexto estável, quais entradas são duplicadas e quais notas desatualizadas devem ser removidas antes que confundam agentes futuros. A saída é mais valiosa quando você a trata como uma revisão editorial do contexto operacional do seu agente.

Como melhorar a skill review

Dê evidências para review, não apenas um comando

A skill review funciona melhor quando o agente consegue inspecionar os arquivos de memória reais e o repositório atual. Garanta que ele possa verificar caminhos referenciados com checagens no sistema de arquivos, em vez de depender apenas do texto da memória. Se você suspeita que alguma orientação está obsoleta, explique o motivo: “we migrated from Jest to Vitest,” “the api/legacy folder was removed,” ou “the deployment process changed last week.”

Peça categorias prontas para decisão

Solicite categorias que correspondam a ações. Bons grupos incluem:

• Promover para instrução durável do projeto
• Consolidar com entradas semelhantes
• Remover por estar obsoleto ou ter baixo valor
• Manter como memória temporária
• Investigar porque a evidência não está clara

Isso evita que a saída de review vire um resumo vago e facilita atualizar CLAUDE.md, a documentação da equipe ou os arquivos de memória depois da auditoria.

Modos de falha comuns a observar

A falha mais comum é promover observações pontuais além do necessário. Um item de memória normalmente só deve ser promovido se for recorrente, tiver natureza de política ou for amplamente útil em sessões futuras. Outra falha é remover entradas só porque são antigas; idade, por si só, não significa obsolescência. Sinais melhores de obsolescência incluem arquivos ausentes, ferramentas substituídas, convenções contraditas ou referências a trabalhos temporários já concluídos.

Itere depois da primeira review

Depois da primeira review, peça ao agente para converter as recomendações em um plano mínimo de patch: o que adicionar, mesclar, remover e verificar novamente. Em seguida, execute review outra vez no modo rápido para confirmar que a memória ficou mais curta, menos duplicada e mais alinhada ao comportamento atual do projeto. Assim, review vira um ciclo contínuo de manutenção, não um relatório único.