✂️ Prompts antigos são prescritivos demais
Ao longo dos anos, muita gente acumulou "andaimes" no prompt: pense passo a passo, seja conciso, use bullets, não invente, responda em no máximo 3 parágrafos. Para o Fable 5.1, a orientação oficial de migração é que esses prompts costumam ser prescritivos demais e reduzem a qualidade.
✓ Tire (o prompt de sistema já cobre)
- ✓"Seja conciso": brevidade e formatação mínima já são o padrão.
- ✓"Pense passo a passo": o raciocínio interno está sempre ligado no Fable 5.1.
- ✓"Seja honesto/genuíno": o prompt proíbe esses modificadores; pedir não acrescenta nada.
- ✓"Resuma a cada 3 passos": ele já dá atualizações curtas durante ferramentas.
✗ Mantenha (isso ele não adivinha)
- ✗Contexto: quem é o público, para que serve o resultado.
- ✗Formato de saída concreto quando importa (tabela com 3 colunas X, Y, Z).
- ✗Restrições reais: prazo, tamanho máximo do arquivo, idioma.
- ✗Critério de pronto: como saber que terminou.
Copie e rode
Reescrever um prompt antigo seu: antes e depois
ANTES (prescritivo):
"Você é um assistente útil. Seja conciso e direto. Pense passo a passo. Não invente informações. Use bullets. Escreva um resumo do texto abaixo em até 5 bullets, em português, sem introdução."
DEPOIS (especificação):
"Resumo para a diretoria (leem em 30 segundos, decidem se aprovam o orçamento). Português. Se algum número do texto estiver ambíguo, marque com [verificar] em vez de escolher um.
<texto>"
💡 Regra de bolso
Cada linha do seu prompt deve conter informação que o modelo não tem. Quem é o leitor, para que serve, qual restrição real. Instruções sobre "como pensar" ou "como ser" quase sempre podem sair.
⏰ Diga o QUANDO, não só o quê
A documentação da Anthropic para a família Opus 4.8 em diante observa que o modelo não alcança capacidades caras ou complexas a menos que tenha certeza de que precisa: memória em arquivo, delegação a subagentes, ferramentas personalizadas. E que isso é dirigível: diga quando cada capacidade se aplica, não só que ela existe.
| Só dizer que existe | Dizer quando usar |
|---|---|
| "Você tem acesso à minha agenda." | "Quando eu mencionar um compromisso ou data, consulte a agenda antes de responder." |
| "Há um arquivo de memória." | "Antes de qualquer tarefa com mais de alguns turnos, leia o arquivo de memória e anote descobertas novas nele conforme avança." |
| "Você pode buscar na web." | "Quando a resposta depender de informação atual (preços, versões, eventos recentes), busque antes de responder em vez de responder de memória." |
| "Pode usar subagentes." | "Quando a tarefa se espalhar por muitos itens independentes (vários arquivos, vários candidatos), delegue em vez de iterar em série." |
Copie e rode
Bloco de gatilhos para colar no início de um projeto ou CLAUDE.md
<quando_usar>
- Informação atual (preço, versão, evento recente): busque antes de responder.
- Tarefa longa (mais de alguns turnos): leia <arquivo de memória ou notas> primeiro e registre o que descobrir.
- Muitos itens independentes: trabalhe em paralelo em vez de um por um.
- Decisão pequena (nome de variável, formato, valor padrão): escolha e siga; anote a escolha. Para mudança de escopo ou ação destrutiva, pergunte antes.
</quando_usar>
📐 Peça o formato, não a fórmula
A documentação de migração observa que a verbosidade dos modelos recentes se calibra à complexidade percebida: respostas curtas para consultas simples, longas para análises abertas. Se você precisa de um tamanho ou estilo específico, o jeito confiável é mostrar, não proibir.
✓ Funciona melhor
- ✓Um exemplo positivo do tamanho e tom desejados.
- ✓"Tabela com colunas: item, custo, risco (baixo/médio/alto)."
- ✓"Três frases. Primeira: a decisão. Segunda: o motivo. Terceira: o próximo passo."
✗ Funciona pior
- ✗"Não seja prolixo." (negativa vaga)
- ✗"Não use jargão, não explique demais, não repita." (três negativas)
- ✗"Responda como um especialista." (papel sem formato)
Copie e rode
Exemplo positivo como molde de saída
Quero a resposta neste molde exato (troque o conteúdo, mantenha a forma):
DECISÃO: Manter o fornecedor atual até março.
MOTIVO: O contrato novo só economiza 4% e exige migração em dezembro, mês de pico.
PRÓXIMO PASSO: Pedir proposta revisada com início em abril.
Agora aplique a: <sua situação>
💡 Positivo antes de negativo
Se você já tem instruções negativas ("não faça X") no prompt, não apague todas de uma vez. A orientação oficial é testar: tire uma, compare, decida.
🎚️ Claude Code: o botão de esforço
No Claude Code, o esforço vem por padrão em xhigh, recomendado para código e trabalho com agentes. A documentação diz que esforço importa mais nestes modelos do que em qualquer anterior: em níveis baixos, o modelo faz menos chamadas de ferramenta, menos preâmbulo e confirmações mais curtas.
Copie e rode
Rodar a mesma tarefa em dois níveis de esforço no Claude Code e comparar
# dentro do Claude Code, ajuste o esforço com o comando de configuração da sessão
# (ex.: /effort low ou /effort high — o nome do comando pode variar com a versão)
# Depois dê a MESMA tarefa nos dois níveis, em sessões separadas:
"Leia os arquivos da pasta <pasta> e me diga quais funções não têm teste. Liste só o nome do arquivo e da função."
⚠️ Não mude o esforço no meio da tarefa
Trocar o nível durante uma sessão invalida o cache de contexto e distorce a comparação. Teste cada nível em sessão separada, com a tarefa completa especificada no primeiro turno.
🗃️ Memória em arquivo e skills no Claude Code
No aplicativo, a memória é gerida pelas seis ferramentas que você testou. No Claude Code, ela é um arquivo de texto que você escreve. A mesma ideia de "ler antes de escrever, editar pontualmente, apagar o que envelheceu" vale, só que na sua mão.
Copie e rode
Criar um CLAUDE.md mínimo com gatilhos e uma regra de memória
# Projeto <nome>
## Contexto
- Público do que produzimos aqui: <quem lê>
- Resultado esperado: <o que "pronto" significa>
## Quando usar o quê
- Dado atual (preço, versão): busque antes de responder.
- Tarefa longa: leia NOTAS.md antes; registre descobertas lá ao final.
- Muitos arquivos: trabalhe em paralelo.
## Regras de memória (NOTAS.md)
- Uma linha por fato. Data no início.
- Corrigir editando a linha, não acrescentando outra contraditória.
- Apagar o que envelheceu.
💡 Skills: o mesmo princípio do app
O prompt capturado exige que o modelo leia o arquivo da skill antes de gerar qualquer arquivo. No Claude Code, você vê isso acontecer: ele abre o SKILL.md. Se você criar a sua, escreva nela QUANDO usar, não só o que ela faz.
🚀 Exemplo completo: tarefa longa bem especificada
Para trabalho longo com agentes, a orientação de migração é clara: coloque a especificação completa da tarefa em um turno bem escrito e rode em esforço alto. Não vá soltando pedaços.
Copie e rode
Molde de tarefa longa para o Claude Code (troque os campos entre < >)
TAREFA: <uma frase: o que deve existir no final>
CONTEXTO
- Projeto: <o que é, para quem>
- Estado atual: <o que já existe e onde>
- Restrições: <linguagem, versões, o que não pode mudar>
CRITÉRIO DE PRONTO
- <teste ou verificação que prova que terminou, ex.: "npm test passa" ou "o arquivo X abre sem erro">
- <segunda verificação, se houver>
AUTONOMIA
- Decisões pequenas (nomes, formato, valores padrão): escolha e anote no final.
- Mudança de escopo ou ação destrutiva (apagar, sobrescrever, publicar): pergunte antes.
SE TRAVAR
- Tente uma alternativa antes de perguntar. Se ainda travar, explique o que tentou em 3 linhas.
ENTREGA
- Lista do que mudou (arquivo por arquivo, uma linha cada) e o resultado do critério de pronto.
Por que cada bloco existe
Critério de pronto
O mais importante
Sem ele, "terminei" é opinião do modelo. Com ele, é verificação. A política de "rodar barato e refazer só o que falhou" da Trilha 3 depende disso.
Autonomia calibrada
Menos perguntas, sem excesso
Modelos recentes tendem a perguntar mais em decisões pequenas. Conceder autonomia no miúdo e manter cautela no grave reduziu a taxa de perguntas em testes da Anthropic sem aumentar excesso.
Se travar
Evita o loop de idas e vindas
Uma tentativa alternativa antes de perguntar. Se travar de novo, o relato curto do que tentou é o que você precisa para ajudar.
🧪 Teste rápido do módulo
Três perguntas. Clique numa opção para ver a resposta.
1. Qual instrução pode sair de um prompt para o Fable 5.1 sem perda, segundo a orientação de migração?
2. Você quer que o modelo use a busca sempre que houver dado atual em jogo. O que funciona melhor?
3. Você rodou a mesma tarefa em low e high e a qualidade foi igual. Conclusão?