Aula 5 · 17 min
"Deixe a página boa" não é meta: o agente decide sozinho que terminou. Meta verificável é um comando com a saída esperada, e uma trava que impede cumprir por atalho. O agente roda em loop até passar. Depois, o que nenhum comando prova (dado próprio, voz, utilidade) fica para o portão humano, antes do push.
Começar a aula
Objetivo: escrever a meta do agente como comando → saída esperada, com trava contra atalho, e só fazer push depois do portão humano.
Clique em cada bloco.
O comando prova o que é mecânico; o portão prova o que é valor.
Clique em cada passo.
Dá para checar com um comando? A resposta é sim ou não? É impossível cumprir sem fazer o trabalho? A prova aparece na saída? Função, regressão e limite estão cobertos?
São as perguntas do modelo goal.md do kit Execução Longa (aberto, do INEMA).
Função: a página faz o que devia (um H1, canônico certo, JSON-LD presente). Regressão: o resto do site não quebrou (testes e build). Limite: o agente não mexeu onde não devia.
No portal do INEMA, a regra é rodar os testes e o build antes do push: o main já quebrou por causa de tradução.
Do checklist dos 16, parte é mecânica (um H1, título de 50 a 60 caracteres, links que respondem 200, JSON-LD válido) e vira comando.
Outra parte é julgamento: dado próprio verificável, leitura humana, teste da troca. Essa vai para o portão 2, de 10 a 20 minutos por página.
O Codex e o Claude Code têm o comando /goal: o agente trabalha até a condição aparecer cumprida na saída. No Claude Code, o avaliador só lê a conversa, então a prova tem de ser impressa.
Pare e intervenha se houver 3 ciclos sem avanço ou se o agente reabrir item já feito.
Troque os caminhos pelos do seu projeto. O que está entre sinais de menor e maior é para preencher.
# Goal — página nova: <slug> ## Resultado A página /<slug>/ pronta para o portão 2, sem quebrar o resto do site. ## Critérios de pronto (comando → saída esperada) **Função** - [ ] grep -c '<h1' dist/<slug>/index.html → 1 - [ ] grep -o 'rel="canonical" href="[^"]*"' dist/<slug>/index.html → https://www.seusite.com/<slug>/ - [ ] grep -c 'application/ld+json' dist/<slug>/index.html → 1 ou mais **Regressão** - [ ] npm test && npm run build → sem erro **Limite** - [ ] git diff --stat -- tests/ docs/CHECKLIST.md → vazio - [ ] git status --porcelain → só a página nova e as 2–3 páginas da escada de links ## Portão humano (o comando não prova) - dado próprio com link para a evidência (checklist 2) - leitura humana: opinião, o que deu errado, voz do autor (checklist 9) - teste da troca (checklist 10) ## Restrições - só pela assinatura; nada de API sem autorização - sem push: o push é meu, depois do portão
/goal A saída do terminal mostra cada comando do goal.md com a saída esperada, e o goal.md tem todos os critérios marcados. Não faça push. Ao terminar, pare e me mostre o diff.
Use uma página nova (ou uma reescrita) do seu site.
Escreva o goal.md da página com pelo menos um critério de função, um de regressão e um de limite, e passe as cinco perguntas em cada um.
Pronto quando: cada critério tem um comando e a saída esperada, há pelo menos uma trava (arquivo congelado ou contagem com conteúdo) e a seção de portão humano lista o que o comando não prova.
Rode o agente com o pedido de loop. Quando ele parar, leia a página como leitor, decida e só então faça o push você mesmo.
Pronto quando: a conversa mostra cada comando com a saída esperada, o goal.md tem a sua aprovação do portão 2 com data, e o push saiu depois dela.
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
"O build passa com 0 falhas" é uma meta de que nível?competência
Pergunta 2 de 4
Qual destes itens do checklist NÃO vira comando e fica para o portão humano?
Pergunta 3 de 4
Por que a prova tem de aparecer impressa na saída quando se usa /goal no Claude Code?
Pergunta 4 de 4
O critério de limite "git diff --stat -- tests/ → vazio" protege contra o quê?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.