Claude Code v2.1.140: Notas sobre o uso de ferramentas do agente, regras mais rigorosas de automodificação, alertas de adiamento

Claude Code v2.1.140 (+622 tokens) trouxe várias atualizações de descrições de ferramentas e prompts que ajustam o comportamento do agente e esclarecem quando usar as ferramentas. Aqui está o resumo relevante:

Notas de uso simplificadas da ferramenta de agente

Novas notas de uso cobrem:

• Quando delegar (fork vs. execução direta)
• Comportamento do fork e como as worktrees isolam os contextos do agente
• Mecânica de retomada após um fork
• Regras de isolamento de worktree
• Suporte a execução em segundo plano
• Lançamentos paralelos e restrições de contexto

Regras de automodificação – lista explícita de caminhos

A regra de automodificação foi expandida de uma descrição vaga para uma lista explícita de caminhos de configuração do agente que constituem automodificação:

.claude/settings.json, CLAUDE.md, CLAUDE.local.md, .claude.json, .claude/rules/, .claude/hooks/, .claude/commands/, .claude/agents/, .claude/skills/, .claude/output-styles/, .claude/workflows/, .claude/routines/, .claude/scheduled_tasks.json, .claude/loop.md, .mcp.json

Exceções: Arquivos em .claude/worktrees/<name>/ são tratados como arquivos de projeto comuns. Um subdiretório .claude/ específico do projeto que não esteja na lista acima não é considerado automodificação por si só.

Limpeza do prompt de fork do worker

Removido "em seu prompt de sistema" da referência "padrão para fork" para que a regra se aplique genericamente à orientação pai.

Ferramenta de soneca – evitar abuso de despertares curtos

A descrição da ferramenta agora inclui um aviso explícito: não agende despertares de intervalo curto para fazer polling de trabalhos em segundo plano rastreados pelo harness – o agente é reativado automaticamente quando termina. Use um heartbeat de fallback mais longo, de 1200s+. A janela de cache abaixo de 5 minutos é apropriada apenas para fazer polling ativo de estados externos que o harness não pode notificar (por exemplo, execuções de CI, status de deploy, filas remotas). Exemplo atualizado de bun build para uma execução de CI.

Ferramenta de escrita – quando usar

Reescrita em formato "Quando usar":

• Criar um novo arquivo
• Substituir completamente um arquivo lido anteriormente

Para alterações parciais, use a ferramenta edit.

Diff completo disponível no GitHub: Piebald-AI/claude-code-system-prompts v2.1.140.