Preciso escrever pedidos longos e detalhados?

Não. Detalhado não é o mesmo que longo. Um bom pedido e específico: objetivo claro, o contexto que importa e como saber que terminou. Muitas vezes cabe em duas ou três frases. O excesso de texto pode até atrapalhar; o que conta e a precisao, não a quantidade de palavras.

E se eu não souber explicar direito o que quero?

Comece pedindo ajuda para entender. Diga o sintoma que você vê e peca ao agente para investigar e explicar o problema antes de corrigir. Muitas vezes a própria explicação dele te da as palavras para formular o pedido certo. Conversar em passos existe justamente para esses casos.

Por que dizer o que NÃO fazer e tao importante?

Porque o agente busca cumprir o objetivo e pode escolher um atalho indesejado, como mudar um teste em vez de corrigir o código. Uma fronteira clara fecha essas portas. Dizer não altere o teste, não mude o visual ou não instale dependencias novas evita surpresas.

Um pedido perfeito garante um resultado perfeito?

Aumenta muito as chances, mas não garante. O agente ainda pode errar, e por isso a revisão continua essencial. O bom pedido reduz mal-entendidos e da um critério de conferencia, o que resolve boa parte dos problemas antes de chegar a você, mas nunca dispensa o seu olhar.

Devo pedir tudo de uma vez ou aos poucos?

Para tarefas pequenas, de uma vez esta bem. Para tarefas maiores, conversar em passos costuma render mais: entender, planejar, executar em partes, conferindo a cada etapa. Assim você corrige o rumo cedo. O módulo de plan mode aprofunda essa forma de trabalhar.

Módulo 3 - A conversa com o agente

A arte de pedir bem

9 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Nomear as três partes de um bom pedido.
Transformar um pedido vago em um pedido claro.
Dizer ao agente também o que NÃO fazer.
Entender por que um bom pedido melhora a revisão.

As três partes de um bom pedido

No módulo anterior você viu que o ciclo do agente começa por entender o pedido. Logo, a qualidade do que você pede molda tudo o que vem depois. A boa noticia e que existe uma receita simples para pedir bem, com três partes. A primeira e o objetivo: o que você quer que aconteca, em uma frase direta. A segunda e o contexto: a informação que ajuda o agente a mirar, como o arquivo envolvido, o comportamento esperado ou a restrição a respeitar. A terceira e o critério de sucesso: como saber que a tarefa terminou, por exemplo um teste que precisa passar.

Diagrama da anatomia de um bom pedido dividido em três blocos empilhados: objetivo (o que quero, em uma frase), contexto (o arquivo, o comportamento esperado, a restrição) e critério de sucesso (o teste que precisa passar), com um exemplo montado ao lado juntando as três partes. — Objetivo, contexto e critério de sucesso: as três partes que transformam um pedido em resultado.

Veja a receita em ação. Um pedido fraco seria melhora o cadastro. O agente não sabe o que melhorar nem quando parou. Um pedido forte seria: no formulário de cadastro, o botao salvar deveria bloquear quando o e-mail esta vazio, mas hoje ele salva mesmo assim; corrija isso é garanta que o teste de cadastro continue passando. Repare que ele tem objetivo (bloquear o salvar), contexto (o formulário, o comportamento atual) e critério (o teste passando). Com isso, o agente mira certo e sabe conferir o próprio trabalho.

Diga também o que não fazer

Uma parte que iniciantes esquecem e definir as fronteiras: o que o agente NÃO deve fazer. Um Claude Code com pressa pode escolher um atalho que resolve o sintoma e cria outro problema. O exemplo clássico e pedir para fazer um teste passar: sem fronteira, ele poderia mudar o próprio teste em vez de corrigir o código, e o teste passaria pelo motivo errado. Dizer conserte o código sem alterar o teste fecha essa porta. Fronteiras comuns incluem não mexer em certos arquivos, não mudar a interface publica ou não instalar novas dependencias.

Pedido sem fronteira (arriscado)

Faca o teste de login passar.
Deixe a página mais rápida.
Ajuste o cálculo do frete.

Pedido com fronteira (seguro)

Faca o teste de login passar corrigindo o código, sem alterar o teste.
Deixe a página inicial mais rápida sem mudar o visual nem quebrar os testes.
Ajuste o cálculo do frete para gratis acima de 200 reais, sem tocar nas outras faixas.

🎮 Jogo da aula

Pedido vago ou pedido claro?

Classifique cada pedido ao Claude Code: ele mira certo ou obriga o agente a adivinhar?

Um receio comum e achar que pedir bem da muito trabalho. Na prática, são poucos segundos a mais que economizam vários minutos de vai e volta. E existe um ganho extra que muita gente não percebe: um pedido com critério de sucesso torna a sua revisão mais fácil. Se você disse qual teste precisa passar, basta conferir se ele passou. Se você disse o comportamento esperado, basta checar esse comportamento. O pedido claro não ajuda só o agente a agir; ajuda você a verificar.

Converse em passos, não em ordens gigantes

Além de pedir bem, vale conversar bem. O Claude Code lembra do contexto dentro da sessão, então você não precisa despejar tudo num único pedido gigante. Muitas vezes rende mais quebrar uma tarefa grande em passos e ir conversando: primeiro peca para ele entender e explicar o problema, depois para propor um plano, depois para executar uma parte, conferindo a cada etapa. Assim você corrige o rumo cedo, quando ajustar e barato, em vez de descobrir no fim que ele foi longe na direção errada.

Esse hábito de conversar em passos conversa direto com o módulo de plan mode, mais a frente, onde você vai aprender um modo em que o agente só planeja antes de tocar em qualquer arquivo. Por ora, guarde a ideia central deste bloco: o Claude Code é um parceiro de diálogo, não uma máquina de comandos de uma única ordem. Quanto mais você trata a interação como uma conversa com idas e voltas, e não como um botao que resolve tudo de uma vez, melhores os resultados e menor a chance de surpresas ruins.

Teste rápido

Por que incluir um critério de sucesso no pedido (como qual teste deve passar) ajuda além de guiar o agente?

Perguntas frequentes

Preciso escrever pedidos longos e detalhados?: Não. Detalhado não é o mesmo que longo. Um bom pedido e específico: objetivo claro, o contexto que importa e como saber que terminou. Muitas vezes cabe em duas ou três frases. O excesso de texto pode até atrapalhar; o que conta e a precisao, não a quantidade de palavras.
E se eu não souber explicar direito o que quero?: Comece pedindo ajuda para entender. Diga o sintoma que você vê e peca ao agente para investigar e explicar o problema antes de corrigir. Muitas vezes a própria explicação dele te da as palavras para formular o pedido certo. Conversar em passos existe justamente para esses casos.
Por que dizer o que NÃO fazer e tao importante?: Porque o agente busca cumprir o objetivo e pode escolher um atalho indesejado, como mudar um teste em vez de corrigir o código. Uma fronteira clara fecha essas portas. Dizer não altere o teste, não mude o visual ou não instale dependencias novas evita surpresas.
Um pedido perfeito garante um resultado perfeito?: Aumenta muito as chances, mas não garante. O agente ainda pode errar, e por isso a revisão continua essencial. O bom pedido reduz mal-entendidos e da um critério de conferencia, o que resolve boa parte dos problemas antes de chegar a você, mas nunca dispensa o seu olhar.
Devo pedir tudo de uma vez ou aos poucos?: Para tarefas pequenas, de uma vez esta bem. Para tarefas maiores, conversar em passos costuma render mais: entender, planejar, executar em partes, conferindo a cada etapa. Assim você corrige o rumo cedo. O módulo de plan mode aprofunda essa forma de trabalhar.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← Manter atualizado e resolver problemas Concluir e avançar →