Tema

Tamanho do texto

Fonte

Entrelinha

MÓDULO 2.3

⌨️ Escrever para o Fable e usar o Claude Code

Prompts escritos para modelos anteriores costumam ser prescritivos demais para o Fable 5.1. Este módulo mostra o que tirar, o que acrescentar, e como o esforço (effort) no Claude Code muda tempo, custo e resultado.

6
Tópicos
50
Minutos
Intermediário
Nível
Prática
Tipo
0 de 60%
1

✂️ 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>"
Como verificar: Rode os dois com o mesmo texto. Compare: o "depois" deve produzir algo mais adequado ao público, com menos preâmbulo. Se ficou pior, anote exatamente o que piorou: isso é o que você devolve como instrução.

💡 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.

2

⏰ 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 existeDizer 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>
Como verificar: Depois de colar, dê uma tarefa que dependa de dado atual e uma tarefa com vários itens. Observe se a busca e o paralelismo acontecem sem você pedir de novo.
3

📐 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>
Como verificar: A resposta deve vir nas três linhas, com os rótulos. Se vier com introdução ou explicação extra, o molde não foi seguido: tente colocar o molde por último no prompt.

💡 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.

4

🎚️ 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.

lowmediumhigh / padrão qualidade relativa -1 a -3 ptsigualpadrão pesquisa -8 pts-2 ptspadrão código longoDuas formas de curva de esforço: quase plana para pesquisa e conhecimento, íngreme para código longo
O que olhar: Na curva plana, descer de nível quase não perde qualidade e corta custo. Na íngreme, cada nível abaixo custa pontos reais. Só medindo sua tarefa você sabe qual curva é a sua.

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."
Como verificar: Anote para cada nível: tempo até a resposta, número de chamadas de ferramenta (o Claude Code mostra), e se a lista está completa. Se a qualidade for igual, o nível baixo venceu para esta tarefa. Se faltou item no baixo, a curva é íngreme aqui.

⚠️ 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.

5

🗃️ 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.

Aplicativo Claude 6 ferramentas de memóriaArquivos geridos pelo modeloRegras de omissão automáticasVocê corrige pedindo Claude Code CLAUDE.md do projetoMemória em pasta localSkills em pastas SKILL.mdVocê edita direto mesma ideia, mão diferente
O que olhar: O que o app faz por você com ferramentas, o Claude Code deixa você fazer com arquivos. Ver os arquivos ensina o que a memória do app está fazendo.

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.
Como verificar: Salve como CLAUDE.md na raiz do projeto, abra o Claude Code na pasta e peça "o que você sabe sobre este projeto?". A resposta deve refletir o arquivo.

💡 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.

6

🚀 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.
Como verificar: Ao final você deve ter: o resultado, a lista de mudanças e a prova do critério de pronto. Se ele parou para perguntar algo que estava no molde, o molde precisa ser mais explícito naquele ponto.

Por que cada bloco existe

1

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.

2

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.

3

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?

📋 Resumo do módulo

Tire o andaime - "seja conciso", "pense passo a passo", "seja honesto" já estão no prompt de sistema ou são proibidos nele.
Diga o quando - gatilhos explícitos para busca, memória e paralelismo. Só dizer que existe não basta.
Mostre o formato - um exemplo positivo curto vale mais que três negativas.
Esforço é o primeiro botão - low/medium/high/xhigh/max. Curva plana em pesquisa; íngreme em código longo. Meça em sessões separadas.
Memória e skills na mão - CLAUDE.md e SKILL.md são a versão visível do que o app faz com ferramentas.
Tarefa longa - especificação completa no primeiro turno, critério de pronto, autonomia calibrada, esforço alto.