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.
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.
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.
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"
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.
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.
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.
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.
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.
Deixe trabalhar
Ele vai fazer várias voltas do ciclo. Você pode acompanhar pelo registro ou ir cuidar de outra coisa.
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.
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 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.
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).
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
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.
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ório | Sim | Muitos passos, fácil de contar |
| 18 cartões de promoção conferidos | Sim | Critério claro, nada sai da pasta |
| Responder todos os e-mails de clientes | Não | Envio a cliente: revise um por um |
| Limpar arquivos antigos da pasta | Não | Apagar é difícil de desfazer |
| Atualizar preços na planilha da loja | Não | Mexe 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
Próximo módulo:
2.1 — Local, nuvem e celular