Alexandre Caramaschi

doi:10.2139/ssrn.6460680

Claude Code CLI: Programação com IA · Capítulo 8 de 23 · 19 min

Pedir o resultado em vez da tarefa ao escrever um prompt

Cinco regras de pedido que transformam uma resposta genérica em entrega pronta para usar.

Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.

Depois de instalar e dominar os comandos, o que decide a qualidade é o pedido. Prompt é o nome técnico da instrução que você dá à IA, como o pedido feito no balcão; prompt engineering é a arte de pedir de forma eficaz para obter as melhores respostas possíveis.

Analogia

Pedir algo à IA é como pedir a um estagiário muito inteligente que acabou de chegar e ainda não conhece seu contexto. Quanto mais claro e específico você for, melhor será o resultado.

Primeira regra: seja específico, nunca genérico.

PromptRegra 1: seja específico

Ruim (genérico):
> Resuma este relatório

Bom (específico):
> Resuma o relatório de vendas de junho em 5 tópicos, com a variação
> de cada número em relação a maio e um alerta para o que caiu
> mais de 10%

Segunda regra: conte a situação, porque sem contexto a IA chuta o tom.

text

# Ruim (sem contexto):
> Melhore este texto

# Bom (com contexto):
> Este texto é a minha fala de abertura para a reunião de diretoria
> de amanhã. O público são os quatro sócios, o clima é de corte de
> custos e eu preciso defender o orçamento da minha área sem soar
> na defensiva. Ajuste o tom mantendo os números.

Terceira regra: mostre um exemplo do que espera, como a forma que dá o formato ao bolo.

PromptRegra 3: dê exemplos do que espera

Ruim (sem exemplo):
> Crie uma função de formatação

Bom (com exemplo):
> Crie uma função Python que formate CPF.
> Entrada: "12345678901"
> Saída esperada: "123.456.789-01"

Quarta regra: divida tarefas grandes em etapas.

text

# Ruim (tarefa gigante de uma vez):
> Prepare a reunião de board do trimestre inteira

# Bom (passo a passo):
> Passo 1: Leia as planilhas da pasta Resultados e monte a tabela
> de indicadores do trimestre
> (depois, na próxima mensagem)
> Passo 2: Compare com o trimestre anterior e destaque as variações
> (depois)
> Passo 3: Escreva o resumo executivo de uma página com as decisões
> que dependem do board

Quinta regra: peça para explicar antes de fazer.

text

# Muito útil para aprender:
> Antes de criar o código, me explique qual será a estrutura
> e por que você escolheu essa abordagem.

# Ou:
> Explique este código linha por linha, como se eu fosse
> um iniciante completo.

Na Brasil GEO, usamos prompts muito específicos. Por exemplo, em vez de pedir "analise os dados", pedimos: "Leia o arquivo geo_metrics.db, tabela citations, filtre por data > 2026-01-01, calcule a média de citações por plataforma e gere um gráfico de barras." Quanto mais preciso, melhor o resultado.

As cinco regras rendem mais quando se juntam num pedido só. O e-mail executivo é o melhor treino: ele exige contexto do destinatário, objetivo explícito, restrições e um formato de saída, tudo de uma vez. Suponha o dono de uma oficina mecânica que precisa pedir ao fornecedor de peças um prazo de entrega menor sem estragar a relação: sem contexto e sem restrição, a IA devolve um e-mail genérico que ele teria de reescrever.

PromptO e-mail executivo perfeito

PAPEL E CONTEXTO
Você é um assessor de comunicação que escreve e-mails em nome de um executivo. Domina o português do Brasil formal, sabe adaptar o tom ao destinatário e vai direto ao ponto.

DADOS DE ENTRADA
- Destinatário: [nome, cargo e a relação dele comigo]
- Objetivo do e-mail: [o que preciso que aconteça depois que a pessoa ler]
- Contexto e histórico: [o que já foi conversado, o que a pessoa já sabe]
- Restrições: [o que não posso prometer, assuntos sensíveis, prazos, tom político]

TAREFA
1. Escreva o e-mail em no máximo três parágrafos curtos, começando pela mensagem principal, não por rodeios.
2. Ajuste o tom ao cargo e à relação com o destinatário.
3. Respeite todas as restrições; não crie compromissos fora do que informei.
4. Sugira dois assuntos de e-mail: um mais direto e um mais diplomático.
5. Aponte, em uma linha separada, qual frase pode soar dúbia e como eu poderia suavizá-la.

FORMATO DE SAÍDA
Assunto sugerido, corpo do e-mail pronto para copiar e, abaixo da assinatura, a observação sobre a frase sensível.

CRITÉRIOS
- Se faltar o objetivo ou o perfil do destinatário, pergunte antes de escrever; um e-mail executivo sem objetivo claro não serve.
- Liste o que você assumiu sobre o contexto que eu não detalhei.
- Entregue um rascunho para a minha aprovação; não envie o e-mail.

Depois da reunião, o mesmo cuidado evita mal-entendidos. Um follow-up (o e-mail de retorno que registra o combinado) bem escrito cobra sem parecer cobrança.

Escolha a próxima reunião da sua agenda e rode os dois prompts: o e-mail antes, o follow-up depois. Se o follow-up sair com cada ação, responsável e prazo e ninguém responder pedindo esclarecimento, as cinco regras estão funcionando.

PromptO follow-up de reunião

PAPEL E CONTEXTO
Você é o secretário-executivo que consolida o follow-up depois das reuniões. Escreve em português do Brasil, curto e sem ambiguidade.

DADOS DE ENTRADA
Vou colar as minhas anotações da reunião de hoje.
[cole aqui as anotações: participantes, temas e o que ficou combinado]

TAREFA
1. Escreva um e-mail de follow-up que abra agradecendo a reunião em uma linha.
2. Liste as decisões tomadas, cada uma em um item.
3. Liste as ações combinadas no formato responsável, tarefa e prazo.
4. Aponte o que ficou em aberto e proponha a próxima data ou o próximo passo.

FORMATO DE SAÍDA
Assunto sugerido e corpo do e-mail, com as ações em lista para facilitar a leitura no celular.

CRITÉRIOS
- Não atribua uma ação a alguém que não apareça nas anotações; se um responsável estiver implícito, pergunte antes de nomear.
- Liste o que você assumiu sobre prazos que não foram ditos com todas as letras.
- É um rascunho para eu conferir antes de mandar aos participantes.

Checkpoint

Pratique: peça algo ao Claude Code usando as 5 regras. Comece com uma tarefa simples, seja específico, dê contexto, forneça um exemplo e peça explicação antes da execução.

Perguntas frequentes deste capítulo

Por que o mesmo tipo de pedido às vezes sai ótimo e às vezes ruim?

Quase sempre a causa é falta de contexto e de especificidade no pedido, não uma limitação do modelo. Quando você diz apenas 'escreva um e-mail', ele preenche as lacunas por conta própria e chuta o tom; quando você diz para quem é, qual o objetivo e o que precisa acontecer, ele acerta. Antes de reclamar do resultado, confira se o pedido trouxe papel, dados, tarefa e formato de saída.

Como faço um prompt que sempre volta no formato que eu quero?

Descreva o formato de forma explícita e, sempre que possível, mostre um exemplo do resultado esperado. Peça algo como 'responda em no máximo cinco tópicos, cada um com uma frase' em vez de deixar a estrutura em aberto. Dar um exemplo de entrada e de saída é o que mais melhora a consistência, porque ele reproduz a estrutura que você mostrou.

Preciso escrever prompts longos e cheios de detalhes toda vez?

O que decide a qualidade é a clareza do pedido, mais do que o número de linhas. Para tarefas simples, uma frase específica basta; para tarefas grandes, o ganho vem de dividir em etapas e pedir que ele explique o plano antes de executar. Esse 'explique antes de fazer' evita retrabalho, porque você corrige o rumo antes de ele produzir a versão errada inteira.

Existe uma estrutura pronta para um pedido executivo, como um follow-up de reunião?

Sim, quatro blocos: papel e contexto (quem ele deve ser e sobre o que), dados (o material bruto), tarefa (o que fazer com aquilo) e formato de saída (como entregar). Para o resumo de uma reunião ficaria assim: 'Você é meu assistente executivo; abaixo estão minhas anotações; extraia decisões e próximos passos; entregue em tópicos com responsável e prazo.' Essa ordem reduz ambiguidade e quase elimina a segunda rodada de ajustes.

Seu caderno neste capítulo

Abrir o caderno completo

Selecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.

Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.

Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.

Conexões deste capítulo

Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.

Estude antes

Depois, siga para

Conceitos deste capítulo

O mesmo assunto em outros cursos

Ver este capítulo no mapa do conhecimento

Leve uma ideia para a prática

Escolha uma atividade no painel e volte a este curso quando quiser.

Atividades e evolução ficam reunidas no painel da sua conta.

Claude Code CLI: Programação com IA · Capítulo 8 de 23 · 19 min

Pedir o resultado em vez da tarefa ao escrever um prompt

Cinco regras de pedido que transformam uma resposta genérica em entrega pronta para usar.

Este capítulo faz parte do curso gratuito Claude Code CLI: Programação com IA.

Analogia

Pedir algo à IA é como pedir a um estagiário muito inteligente que acabou de chegar e ainda não conhece seu contexto. Quanto mais claro e específico você for, melhor será o resultado.

Primeira regra: seja específico, nunca genérico.

PromptRegra 1: seja específico

Ruim (genérico):
> Resuma este relatório

Bom (específico):
> Resuma o relatório de vendas de junho em 5 tópicos, com a variação
> de cada número em relação a maio e um alerta para o que caiu
> mais de 10%

Segunda regra: conte a situação, porque sem contexto a IA chuta o tom.

text

# Ruim (sem contexto):
> Melhore este texto

# Bom (com contexto):
> Este texto é a minha fala de abertura para a reunião de diretoria
> de amanhã. O público são os quatro sócios, o clima é de corte de
> custos e eu preciso defender o orçamento da minha área sem soar
> na defensiva. Ajuste o tom mantendo os números.

Terceira regra: mostre um exemplo do que espera, como a forma que dá o formato ao bolo.

PromptRegra 3: dê exemplos do que espera

Ruim (sem exemplo):
> Crie uma função de formatação

Bom (com exemplo):
> Crie uma função Python que formate CPF.
> Entrada: "12345678901"
> Saída esperada: "123.456.789-01"

Quarta regra: divida tarefas grandes em etapas.

text

# Ruim (tarefa gigante de uma vez):
> Prepare a reunião de board do trimestre inteira

# Bom (passo a passo):
> Passo 1: Leia as planilhas da pasta Resultados e monte a tabela
> de indicadores do trimestre
> (depois, na próxima mensagem)
> Passo 2: Compare com o trimestre anterior e destaque as variações
> (depois)
> Passo 3: Escreva o resumo executivo de uma página com as decisões
> que dependem do board

Quinta regra: peça para explicar antes de fazer.

text

# Muito útil para aprender:
> Antes de criar o código, me explique qual será a estrutura
> e por que você escolheu essa abordagem.

# Ou:
> Explique este código linha por linha, como se eu fosse
> um iniciante completo.

PromptO e-mail executivo perfeito

PAPEL E CONTEXTO
Você é um assessor de comunicação que escreve e-mails em nome de um executivo. Domina o português do Brasil formal, sabe adaptar o tom ao destinatário e vai direto ao ponto.

DADOS DE ENTRADA
- Destinatário: [nome, cargo e a relação dele comigo]
- Objetivo do e-mail: [o que preciso que aconteça depois que a pessoa ler]
- Contexto e histórico: [o que já foi conversado, o que a pessoa já sabe]
- Restrições: [o que não posso prometer, assuntos sensíveis, prazos, tom político]

TAREFA
1. Escreva o e-mail em no máximo três parágrafos curtos, começando pela mensagem principal, não por rodeios.
2. Ajuste o tom ao cargo e à relação com o destinatário.
3. Respeite todas as restrições; não crie compromissos fora do que informei.
4. Sugira dois assuntos de e-mail: um mais direto e um mais diplomático.
5. Aponte, em uma linha separada, qual frase pode soar dúbia e como eu poderia suavizá-la.

FORMATO DE SAÍDA
Assunto sugerido, corpo do e-mail pronto para copiar e, abaixo da assinatura, a observação sobre a frase sensível.

CRITÉRIOS
- Se faltar o objetivo ou o perfil do destinatário, pergunte antes de escrever; um e-mail executivo sem objetivo claro não serve.
- Liste o que você assumiu sobre o contexto que eu não detalhei.
- Entregue um rascunho para a minha aprovação; não envie o e-mail.

Depois da reunião, o mesmo cuidado evita mal-entendidos. Um follow-up (o e-mail de retorno que registra o combinado) bem escrito cobra sem parecer cobrança.

PromptO follow-up de reunião

PAPEL E CONTEXTO
Você é o secretário-executivo que consolida o follow-up depois das reuniões. Escreve em português do Brasil, curto e sem ambiguidade.

DADOS DE ENTRADA
Vou colar as minhas anotações da reunião de hoje.
[cole aqui as anotações: participantes, temas e o que ficou combinado]

TAREFA
1. Escreva um e-mail de follow-up que abra agradecendo a reunião em uma linha.
2. Liste as decisões tomadas, cada uma em um item.
3. Liste as ações combinadas no formato responsável, tarefa e prazo.
4. Aponte o que ficou em aberto e proponha a próxima data ou o próximo passo.

FORMATO DE SAÍDA
Assunto sugerido e corpo do e-mail, com as ações em lista para facilitar a leitura no celular.

CRITÉRIOS
- Não atribua uma ação a alguém que não apareça nas anotações; se um responsável estiver implícito, pergunte antes de nomear.
- Liste o que você assumiu sobre prazos que não foram ditos com todas as letras.
- É um rascunho para eu conferir antes de mandar aos participantes.

Checkpoint

Pratique: peça algo ao Claude Code usando as 5 regras. Comece com uma tarefa simples, seja específico, dê contexto, forneça um exemplo e peça explicação antes da execução.

Perguntas frequentes deste capítulo

Por que o mesmo tipo de pedido às vezes sai ótimo e às vezes ruim?

Como faço um prompt que sempre volta no formato que eu quero?

Preciso escrever prompts longos e cheios de detalhes toda vez?

Existe uma estrutura pronta para um pedido executivo, como um follow-up de reunião?

Seu caderno neste capítulo

Abrir o caderno completo

Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.

Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.

Pedir o resultado em vez da tarefa ao escrever um prompt

Perguntas frequentes deste capítulo

Seu caderno neste capítulo

Conexões deste capítulo

Estude antes

Depois, siga para

Conceitos deste capítulo

O mesmo assunto em outros cursos

Leve uma ideia para a prática

Privacidade e cookies

Pedir o resultado em vez da tarefa ao escrever um prompt

Perguntas frequentes deste capítulo

Seu caderno neste capítulo

Conexões deste capítulo

Estude antes

Depois, siga para

Conceitos deste capítulo

O mesmo assunto em outros cursos

Leve uma ideia para a prática

Privacidade e cookies