Entendendo o Prompt Magico (/loop e /goal) · Oletros

Quem trabalha com agentes como o Claude Code esta se deparando com uma alteracao na forma como interagimos com ele, deixando de ficar digitando instrucoes passo a passo e passando a usar o que esta sendo conhecido como Prompt Magico atraves dos comandos /loop e /goal.

Mas o que eh o Prompt Magico ?

Eh executar um agente de forma autonomo e focado em um estado final ao inves de comandos/interacoes isolados.

Em vez de voce dizer: "Corrija a linha 45... agora execute o teste... agora corrija o erro X", voce define uma meta de sucesso verificavel e o agente cria um loop interno onde ele executa a acao, testa o resultado por conta propria, analisa a falha e reescreve o codigo ate alcancar o objetivo.

A Anatomia do prompt

Para que um prompt magico nao entre em loop infinito (o que gastaria todos os seus tokens), ele precisa de tres pilares estruturais rigidos:

O Objetivo (Done State): Uma definicao matematica ou factual do que eh o sucesso. Ex: "Passar em 100% dos testes da suite X".
A Metrica (O Avaliador): A ferramenta, teste, script, etc que o agente vai rodar para checar se atingiu o objetivo.
A Fronteira (Stop Condition): O limite de seguranca. Ex: "Tente no maximo 5 vezes"

Exemplo Pratico como DEV

Imagine que voce quer refatorar uma funcao que esta lenta no seu backend: um prompt tradicional seria apenas pedir para otimizar.

Como ficaria Um Prompt Magico equivalente:

/goal Otimizar a funcao de busca no banco de dados para que o benchmark local rode abaixo de 50ms, mantendo a compatibilidade com a suite de testes atual. Limite a execucao a 6 iteracoes.

O que acontece nos bastidores ?

Loop 1: O agente altera o index do banco. Roda o benchmark. O resultado da 70ms.
Loop 2: O agente percebe que nao atingiu a meta e reescreve a query usando um JOIN diferente. Roda o benchmark. O resultado da 45ms.
Loop 3: O benchmark passou, mas um teste de integracao quebrou. O agente reescreve o codigo para corrigir o teste sem perder a performance.
Fim: O benchmark da 42ms e os testes passam. O agente encerra o loop e te entrega o resultado final consolidado.

Isso pode auxiliar na produtividade

O foco do desenvolvedor deixa de ser "como escrever o prompt perfeito para gerar codigo" e passa a ser "como construir a melhor suite de testes e o melhor ambiente de validacao".

Se voce fornecer os testes corretos, o agente resolve o problema rodando em loop enquanto voce foca na arquitetura do software.

A diferenca entre /loop e /goal

A diferenca de uso entre /loop e /goal refere-se ao controle de interacoes e autonomia do agente.

/loop: O agente segue o fluxo pre-definido cegamente ate que uma condicao de parada (como numero de tentativas) seja alcancada: Eh como programar um loop while ou for tradicional no codigo.
/goal: Voce define a meta e o agente decide autonomamente quais acoes tomar a cada tentativa para chegar la. Se o plano A falhar no primeiro ciclo, ele muda a estrategia no ciclo seguinte por conta propria. Como age de forma autonoma o agente cria, testa, falha, aprende com o erro e muda a abordagem sem que voce precise intervir entre os ciclos. Eh como dar um destino para o GPS: Voce nao diz quais ruas virar; se o transito parar, o GPS recalcula a rota sozinho ate te deixar no destino.

Comparacao Direta

Caracteristica	/loop	/goal
Quem decide o proximo passo ?	O seu prompt original (fluxo fixo).	O proprio agente (autonomia dinamica).
Criterio de parada	Geralmente numero fixo de voltas.	Quando a meta eh atingida ou testada.
Ideal para...	workflows pre-definidos.	resolucao de um problema

Simulando um /goal em um agente que nao tenha

OK, teu agente nao tem o /goal e agora ?

Voce pode tentar o prompt abaixo (exemplo de otimizacao SEO):

Voce vai agir sob o protocolo /goal.

[OBJETIVO]: Otimizar o artigo abaixo para SEO com a palavra-chave "inteligencia artificial".

[REGRAS DO LOOP]: Voce deve criar o rascunho. Em seguida, voce vai assumir o papel de um Especialista em SEO (Juiz) e dar uma nota de 1 a 10.

[CRITERIO DE PARADA]: Se a nota do Juiz for menor que 9, voce deve reescrever o texto corrigindo as falhas apontadas pelo Juiz. Repita o processo. So pare e me mostre o resultado final quando a nota for 9 ou 10, ou quando atingir o limite de 4 iteracoes.

Funciona ? Mais ou menos: o ideal eh criar agentes separados para cada acao (subagente escrita/acao, subagente juiz) pois usar o mesmo processo para acao/julgamento geralmente tem resultados condescendentes.

O "Gauntlet Loop"

Eh uma das arquiteturas de implementacao do Prompt Magico.

A relacao entre eles eh a seguinte: o Prompt Magico eh o conceito filosofico (trabalhar de forma autonoma ate atingir uma meta), enquanto o Gauntlet Loop eh uma a estrutura usada para garantir que esse objetivo seja alcancado com qualidade.

Em termos simples: o Prompt Magico eh o "O que" (a meta) e o Gauntlet Loop eh o "Como" (a pista de obstaculos que valida a meta).

Em vez de usar apenas um Juiz comum, a arquitetura de Gauntlet coloca o rascunho inicial criado pelo agente para passar por uma pista de testes sequenciais com multiplos validadores especializados. Cada validador representa um "obstaculo" diferente.

O loop so termina quando o rascunho inicial consegue atravessar todos os obstaculos do corredor sem ser reprovado por nenhum deles.

                  ┌──────────────────────────────────────────────┐
                  │              1. AGENTE ESCRITOR              │◄──────────────────┐
                  │         (Gera o rascunho inicial)            │                   │
                  └──────────────────────┬───────────────────────┘                   │
                                         │                                           │
                                         ▼                                           │
 ┌─────────────────────────────────────────────────────────────────────────────────┐ │
 │                GAUNTLET LOOP (se algum falhar, reinicia o ciclo)                │ │
 │                                                                                 │ │
 │   ┌───────────────────┐     ┌───────────────────┐     ┌───────────────────┐     │ │ 
 │   │   2. JUIZ DE SEO  │────►│ 3. JUIZ DE RITMO  │────►│ 4. JUIZ FACTUAL   │     │ │
 │   │ (Palavras-chave?) │     │(Leitura fluida?)  │     │(Dados veridicos?) │     │ │
 │   └───────────────────┘     └───────────────────┘     └───────────────────┘     │ │ 
 └─────────────────────────────────────────────────────────┬───────────────────────┘ │
                                                           │                         │
                                                           │ Passou por TODOS        │
                                                           ▼                         │
                                                    [ TEXTO FINAL ] ─────────────────┘

O GAUNTLET LOOP procura evitar o "Ponto Cego" de um Juiz Unico: Se voce criar um Prompt Magico com apenas um Juiz Geral, a tendencia eh o agente aceitar solucoes medianas, enquanto que o Gauntlet divide a avaliacao em mini-especialistas hiper-focados.

Neste caso o /loop e /goal podem trabalhar juntos: usando o /goal para estabelecer a meta desejada (agente orquestrador) e o /loop os testes (agente validador)

Eh so lembrar que o /goal eh focado no resultado (como "dono" do projeto, ele define a regra de encerramento total da tarefa) enquanto que o /loop eh focado no processo.

Saude e Sucesso !

Este post foi favoritado via extensão TABNEWS FAVORITOS

Tem curiosidade sobre IA ? Da uma olhada no meu LIVRO: IA PARA ENGENHEIROS