Claude Code v2.1.91 Atualizações: Padrões de Design de Agente, Regras de Memória e Melhorias de Ferramentas

Claude Code v2.1.91 introduz atualizações nos padrões de design de agentes, regras de gerenciamento de memória e funcionalidade de ferramentas. A versão adiciona um guia de referência para construir agentes na API Claude e modifica vários recursos existentes.

Novo Guia de Padrões de Design de Agentes

A atualização adiciona um guia de referência Skill: Padrões de Design de Agentes que cobre heurísticas de decisão para construir agentes. Isso inclui orientações sobre design de superfície de ferramentas, gerenciamento de contexto, estratégias de cache e composição de chamadas de ferramentas. O guia é referenciado em vários locais, incluindo a skill Construir com API Claude e a documentação de conceitos de uso de ferramentas.

Mudanças no Gerenciamento de Memória

O prompt do agente "Determinar quais arquivos de memória anexar" agora usa uma regra mais simples: não reselecionar memórias já retornadas para uma consulta anterior na mesma conversa. Isso substitui a regra anterior sobre pular memórias para ferramentas usadas recentemente. O prompt esclarece que a primeira mensagem lista as memórias disponíveis e as mensagens subsequentes contêm cada uma uma consulta do usuário.

O monitoramento de segurança para ações autônomas de agentes agora inclui uma regra de BLOQUEIO "Envenenamento de Memória" que cobre gravações no diretório de memória do agente que funcionariam como concessões de permissão, desvios de regras BLOQUEIO ou autorizações de usuário fabricadas. Uma exceção de PERMITIR correspondente "Diretório de Memória" permite gravações rotineiras de memória (preferências do usuário, fatos do projeto, referências) que não constituem envenenamento.

Melhorias nas Ferramentas

• Ferramenta Editar: Removida a nota inline sobre edições falharem quando old_string não é único; substituída por um espaço para diretrizes adicionais de edição.
• Ferramenta LerArquivo: Adicionado suporte para caminhos de arquivo relativos (preferidos por brevidade) como uma alternativa condicional ao requisito de apenas caminho absoluto. Tornou configurável o limite padrão de leitura de linhas e as notas adicionais de leitura.
• Ferramenta Escrever: Substituiu o requisito genérico "ler primeiro" por uma nota condicional para novos arquivos. Tornou configurável a orientação "preferir Editar".

Atualizações de Documentação e Skills

As fontes de documentação ao vivo adicionaram URLs WebFetch para seis páginas adicionais de documentação de ferramentas: Ferramenta Bash, Editor de Texto, Ferramenta de Memória, Busca de Ferramentas, Chamada Programática de Ferramentas e Skills. Edição de Contexto foi adicionada à seção Recursos Avançados.

A documentação de conceitos de uso de ferramentas adicionou novas seções para Skills (pacotes de instruções específicas para tarefas carregados sob demanda) e Edição de Contexto (poda de resultados de ferramentas obsoletos da transcrição). A descrição de Chamada Programática de Ferramentas foi expandida para explicar o problema de custo de ida e volta e como os scripts são executados no contêiner de execução de código.

A skill Verificar agora inclui um veredito SKIP para alterações sem superfície de execução (apenas documentação, apenas tipos, apenas testes), distinto de BLOQUEADO que agora significa estritamente que o verificador não pôde alcançar um estado observável. Testes no diff são considerados evidência do autor, não uma superfície de verificação.

Recursos Removidos

• Prompt do Agente: comando de barra /pr-comments para buscar e exibir comentários de PR do GitHub
• Prompt do Agente: Atualizar Magic Docs

A skill Construir com API Claude agora recomenda esforço médio como um equilíbrio favorável e esforço máximo quando a correção importa mais que o custo.