Anthropic detalha novas regras de context engineering para Claude 5

O que mudou

A Anthropic removeu mais de 80% do system prompt do Claude Code para modelos da geração Claude 5 (como Opus 5 e Fable 5) sem perda mensurável nas avaliações de código. O motivo: os modelos mais novos têm julgamento suficiente para dispensar regras rígidas que antes eram necessárias para evitar cenários ruins.

Princípios antigos que viraram mitos

O post, escrito por Thariq Shihipar (membro do time técnico da Anthropic), lista seis transições de prática:

• Regras → Julgamento: Antes, instruções como "nunca escreva comentários multi-parágrafo" eram necessárias porque modelos antigos erravam. Agora, a orientação é "escreva código que leia como o código ao redor" e deixar o modelo decidir.
• Exemplos → Design de interfaces: Dar exemplos de uso de ferramentas agora restringe o modelo a um espaço de exploração limitado. Melhor: desenhar ferramentas com parâmetros expressivos que comuniquem a intenção por si só.
• Tudo upfront → Divulgação progressiva: Em vez de colocar toda informação no system prompt, carregar contexto sob demanda. Skills e ferramentas com "deferred loading" só ocupam contexto quando necessárias.
• Repetição → Descrições simples: Modelos antigos precisavam de instruções repetidas no system prompt e na descrição da ferramenta. Agora basta colocar a instrução na descrição da ferramenta.
• Memória em CLAUDE.md → Auto-memória: Claude agora salva automaticamente memórias relevantes, sem necessidade do hotkey # para escrever no CLAUDE.md.
• Specs simples → Referências ricas: Em vez de arquivos markdown simples, Claude lida bem com artefatos HTML, suites de teste como especificação, código de outros repositórios como referência, e rubricas com agentes verificadores.

Como aplicar ao seu contexto

• System prompt: Se você constrói seu próprio agente, invista tempo aqui. No Claude Code, ele raramente precisa de modificação.
• CLAUDE.md: Mantenha leve. Descreva o repositório brevemente e foque em "gotchas" do codebase. Evite dizer o óbvio que Claude já infere do sistema de arquivos.
• Skills: Guias leves para Claude encontrar informação quando precisar. Evite overconstraint. Divida skills longas em múltiplos arquivos.
• Referências: Prefira arquivos em código (HTML mockups, testes) sobre descrições em texto ou screenshots.

A Anthropic lançou o comando claude doctor (acessível via /doctor no Claude Code) para ajudar a redimensionar automaticamente skills e arquivos CLAUDE.md.