Pular para o conteúdo
MÓDULO 1.4 · CONCEITO 4 DE 18

🎯 /goal: um objetivo até o fim

Com o /goal, você não dá um pedido: dá um objetivo. O Codex tenta, encontra obstáculos, muda de caminho e só para quando chega lá ou quando você interrompe.

6
Tópicos
~35
Minutos
Base
Nível
Prática
Tipo
0 de 60%
Ilustração: um caminho sobe em degraus até uma bandeira no alto, com alguns desvios ao redor de obstáculos. O caminho mostra o /goal: o agente persegue um objetivo claro, contorna o que trava e só para quando chega à bandeira.
1

Entenda o que muda com um objetivo

Num pedido comum, o Codex faz o ciclo do módulo anterior e responde. Se bater num obstáculo, costuma parar e perguntar: "não achei o arquivo, o que faço?". Você volta, explica, ele continua.

Com o /goal é diferente. Você define um objetivo, e ele persegue esse objetivo até o fim: tenta, confere, ajusta, tenta outro caminho. Só para quando chega lá, ou quando você manda parar.

🆕 Novo aqui? Quatro palavras deste módulo

  • /goal — um comando de barra que você digita na caixa de mensagem, seguido do objetivo. "Barra" porque começa com /.
  • Objetivo — o resultado final que você quer, descrito de um jeito que dê para saber se foi atingido.
  • Critério de pronto — a frase que diz quando acabou: "30 fontes", "2 páginas", "conferido em captura de tela".
  • Captura de tela — uma foto da tela. O agente pode tirar uma para conferir se o que fez ficou certo.
Pedido comum ? para e espera você Com /goal outro caminho objetivo cumprido

Como ler o desenho: o bloco vermelho é o mesmo obstáculo nas duas faixas. Em cima, o agente para e devolve a decisão para você. Embaixo, ele procura outra saída sozinho e só termina na bandeira.

💡 Pedido é um passo; objetivo é o destino

"Leia estes artigos" é um passo. "Reúna 30 fontes confiáveis e entregue um relatório de 2 páginas" é um destino. O /goal brilha quando há vários passos entre você e o resultado.

2

Escreva um objetivo verificável

O agente precisa saber quando acabou. Por isso o melhor objetivo é verificável: tem número, formato ou uma conferência que dá para fazer.

A Paula escreveu: "reúna 30 fontes sobre retenção de talentos e escreva um relatório de 2 páginas". O Rui: "crie 1 capa e 18 cartões de produto para as promoções e confira cada um em captura de tela antes de terminar". Os dois sabem exatamente o que vão receber.

/goal do Rui: promoções da semana ✓1 capa criada ✓18 cartões de produto criados ✓cada cartão conferido em captura de tela 18 de 18 conferidos PRONTO dá para contar e conferir

Como ler o desenho: cada linha do quadro é uma parte do objetivo que dá para marcar. Quando todas estão marcadas, o agente sabe que terminou, e você sabe o que conferir. Sem número nem conferência, não existe selo de "pronto".

✗ Objetivo vago

  • ✗ "Melhore meus posts"
  • ✗ "Faça um relatório bom sobre RH"
  • ✗ "Arrume o catálogo da loja"
  • ✗ "Pesquise bastante"

✓ Objetivo verificável

  • ✓ "Reescreva os 5 últimos posts seguindo linkedin/estilo.md"
  • ✓ "Relatório de 2 páginas com 30 fontes listadas no fim"
  • ✓ "Todo produto do catálogo com preço e foto"
  • ✓ "Pare quando tiver 10 exemplos diferentes"
3

Use objetivos subjetivos com cuidado

Nem todo objetivo cabe num número. "Deixe o texto da página da loja mais convidativo" é subjetivo. Funciona, mas tem um preço: quem decide quando acabou é o agente, não você.

A saída é transformar o gosto em critérios. Em vez de "até ficar bom", escreva o que "bom" quer dizer para você: frases curtas, preço visível, um convite claro para visitar a loja.

subjetivo verificável "até ficar satisfeito" "mais convidativo" +3 critérios escritos 18 cartões conferidosem captura de tela cada critério escrito empurra o objetivo para a direita

Como ler o desenho: quanto mais à esquerda, mais o agente decide sozinho quando parar. Quanto mais à direita, mais você controla o resultado. Você não precisa chegar ao verde sempre, mas cada critério escrito ajuda.

💡 Peça que ele mostre os critérios antes

Num objetivo subjetivo, comece com: "antes de começar, liste os critérios que você vai usar para decidir que terminou". Você ajusta a lista em um minuto e evita uma hora de trabalho no rumo errado.

4

Rode seu primeiro /goal

Comece com um objetivo pequeno, sem risco e fácil de conferir. A Paula escolheu organizar a pesquisa de um post: nada é enviado a ninguém, e o resultado fica num arquivo da pasta.

Siga os passos abaixo no seu projeto. Por dentro, o agente vai girar um laço de tentar → conferir → ajustar até bater o critério.

1

Abra uma conversa nova no projeto

Confira na barra lateral que o projeto certo está ativo. O AGENTS.md dele vale também durante o objetivo.

2

Digite /goal e o objetivo

Escreva /goal na caixa de mensagem, seguido do objetivo com o critério de pronto e o que ele NÃO pode fazer.

3

Deixe trabalhar

Ele vai fazer várias voltas do ciclo. Você pode acompanhar pelo registro ou ir cuidar de outra coisa.

4

Confira contra o critério

Quando ele disser que terminou, abra o arquivo e confira item por item. O critério que você escreveu vira a sua lista de conferência.

💬 Copia e cola no Codex: seu primeiro objetivo

Objetivo: rodar um /goal sem risco, com critério de pronto que dá para contar.

/goal Monte o arquivo pesquisa/<tema>.md com 10 ideias de post sobre <tema>, cada uma com título, uma frase de explicação e um exemplo do dia a dia. Antes de terminar, confira que são 10 ideias diferentes e que nenhuma repete outra. Não apague nem altere nenhum outro arquivo da pasta.
Como verificar: abra o arquivo criado e conte as ideias. Têm de ser 10, cada uma com título, frase e exemplo. No registro, procure o momento em que ele conferiu a lista antes de encerrar.
critério de pronto 10 ideias diferentes 1. tentar 2. conferir 3. ajustar não bateu bateu 📄 arquivo final 10 ideias conferidas

Como ler o desenho: o laço azul gira em volta do critério tracejado. A cada volta, a etapa "conferir" compara o resultado com o critério. Só quando bate, a seta verde leva ao arquivo final.

5

Saia do caminho sem perder o controle

Os modelos atuais rendem mais quando recebem o objetivo e ficam livres para escolher o caminho. Interromper a cada passo com "agora faça assim" costuma atrapalhar: ele perde o fio e recomeça.

Sair do caminho não é largar de mão. O controle fica no começo e no fim: no começo, você escreve o critério e os limites; no fim, você confere. No meio, se algo sair muito do rumo, dá para parar a qualquer momento pelo botão de interromper perto da caixa de mensagem (o nome do botão pode mudar entre versões).

você: critérioe limites agente agente agente você: confere ⏹ parar (sempre à mão) sem microgerenciar

Como ler o desenho: os degraus verdes são seus, os azuis são do agente. Você atua no primeiro e no último. O botão vermelho fica acima da escada inteira: é o freio de emergência, não o volante.

✓ Controle que funciona

  • ✓ Critério de pronto escrito antes
  • ✓ Lista do que ele NÃO pode fazer
  • ✓ Espiar o registro de vez em quando
  • ✓ Conferir item por item no fim

✗ Microgerenciar

  • ✗ Mandar uma ordem nova a cada minuto
  • ✗ Mudar o objetivo no meio do caminho
  • ✗ Interromper só porque o caminho é diferente do seu
  • ✗ Aceitar o "terminei" sem conferir
6

Saiba quando não usar /goal

Um agente que não para até cumprir o objetivo é ótimo para pesquisa e organização. Para algumas tarefas, é exatamente o que você não quer. Quanto mais ele insiste, maior o estrago se o caminho for errado.

Três sinais de alerta: risco (dinheiro, apagar arquivos, enviar e-mail a cliente), objetivo vago e nenhum jeito de conferir. Com qualquer um deles, prefira pedidos comuns, passo a passo.

1. envolve dinheiro,apagar ou enviar? 2. o objetivoé claro? 3. dá para conferiro resultado? pedido passo a passo escreva critérios primeiro pedido passo a passo simnãonão nãosim sim 🎯 use /goal

Como ler o desenho: siga as perguntas da esquerda para a direita. Qualquer saída para baixo tira você do /goal: vermelho pede passo a passo, amarelo pede critérios antes. Só quem passa pelas três chega ao quadro verde.

Tarefa/goal?Por quê
Pesquisa de 30 fontes para um relatórioSimMuitos passos, fácil de contar
18 cartões de promoção conferidosSimCritério claro, nada sai da pasta
Responder todos os e-mails de clientesNãoEnvio a cliente: revise um por um
Limpar arquivos antigos da pastaNãoApagar é difícil de desfazer
Atualizar preços na planilha da lojaNãoMexe com dinheiro: confirme cada mudança

O que olhar na tabela: as tarefas com "Sim" só criam coisas novas dentro da pasta. As com "Não" mudam algo que já existe ou chegam a outras pessoas. Essa é a linha que separa os dois mundos.

Teste rápido (opcional): qual destes é o melhor uso do /goal?

🎓 Resumo do módulo

✓
/goal persegue um destino — tenta, confere e ajusta até chegar.
✓
Objetivo verificável — número, formato ou conferência.
✓
Subjetivo com critérios — senão ele decide quando parar.
✓
Controle no começo e no fim — limites antes, conferência depois.
✓
Risco, vagueza ou sem conferência — nada de /goal.

Próximo módulo:

2.1 — Local, nuvem e celular