Aula 2 · 18 min
No piloto do kit, com critério nível 3 e 14 testes congelados, a execução terminou no primeiro ciclo, em 3 minutos. A maior parte do trabalho de uma execução longa é escrever o critério. Aqui você escreve o seu goal.md de forma que o único jeito de cumprir seja fazer o trabalho.
Começar a aula
Objetivo: escrever um goal.md com critérios comando → saída que cubram função, regressão e limite e que não se cumpram por atalho.
Um goal.md bom tem estas cinco partes. Clique em cada uma.
Função + regressão + limite, cada um com trava, e a prova visível. A escala 0–4 completa é do curso 0; como montar o verificador, do curso 1.
Cada "não" derruba o nível do critério.
"Deixar bom" e "revisado e limpo" não têm comando. Reescreva até ter um.
python3 validar.py && echo OK → OK
"Melhorou a performance" é comparação. Fixe o número: "p95 abaixo de 200 ms no benchmark X".
Procure a trapaça mais barata: apagar teste, página vazia, valor fixo no código. Para cada uma, uma trava: contagem mínima, hash ou git diff dos testes, validador do conteúdo.
"0 falhas" vira "0 falhas E ≥ 48 testes E tests/ intocado".
Para o /goal do Claude, escreva a condição como algo que o agente imprime: "a saída do npm test mostra 0 falhas". "O state.md diz concluído" só vale se o agente mostrar o arquivo.
Os três, cada um com pelo menos uma linha. E dois testes: um rápido por ciclo (segundos ou minutos) e o completo no final.
Exemplo preenchido para uma tarefa pequena (contar palavras). Troque pelo seu.
# Goal — contador-palavras - **Início:** 2026-10-19 09:00 · **Agente:** Claude /goal - **Tetos:** tempo 2 h · memória 2G ## Resultado `conta.py` tem conta_palavras(texto) que conta palavras separadas por qualquer espaço. ## Critérios de pronto (verificáveis) **Função** - [ ] `python3 -m pytest -q` → `3 passed`, 0 failed (e nunca menos de 3 testes) **Regressão** - [ ] `python3 -c "import conta"` → sem erro (o módulo continua importável) **Limite** - [ ] `git diff --exit-code -- tests/ pytest.ini` → código 0 (testes congelados) - [ ] `git diff --stat` → só `conta.py` e a pasta longrun/ **Teste rápido por ciclo**: `python3 -m pytest -q` **Teste completo no final**: `python3 -m pytest -q` ## Restrições - só pela assinatura; nenhuma API - não mexer em: tests/, pytest.ini ## Portões humanos (parar e perguntar) - qualquer mudança fora de conta.py e da pasta longrun/
/goal A saída do terminal mostra <comando de verificação> passando com <resultado esperado>, e longrun/<pasta>/state.md diz "concluído".
/goal RESULTADO: <resultado final em uma frase> VERIFICAÇÃO (só termina quando todos passarem): - <comando> → <saída esperada> RESTRIÇÕES: <o que não pode>. Uso só pela assinatura; nenhuma API sem autorização. ESTADO: use longrun/<pasta>/ (goal.md, plan.md, state.md, progress.md, failures.md, decisions.md, canal.md). Após qualquer compactação ou retomada, releia goal.md, state.md, plan.md e canal.md antes de agir. Registre no canal.md (só acrescentar) fatos, aprendizados, glossário e armadilhas assim que surgirem. CICLO: analisar → escolher a próxima ação útil → executar → testar → observar → corrigir → atualizar state/progress → commit no checkpoint → continuar. Enquanto existir uma próxima ação objetiva, segura e alinhada ao objetivo, execute-a sem esperar nova instrução. 3 ciclos sem avanço mensurável = parar, registrar em failures.md e me chamar. PARE E ME CHAME SÓ SE: gasto de crédito/API, ação irreversível ou externa (push em produção, e-mail, apagar), credencial ausente, decisão de negócio, conflito real entre requisitos.
Do longrun/2026-10-01-medir-sessao/goal.md do kit, a execução que construiu o medir-sessao.py:
Função - pytest -q → todos passam (12 rápidos + 2 com sessões reais), 0 falhas, 0 skips Regressão - python3 tools/medicao/cx.py | head -1 e cc.py continuam rodando Limite - git diff --exit-code -- tests/ pytest.ini → vazio (testes congelados; hash inicial 3ae1ba7975508cba) - só criar/alterar tools/medir-sessao.py e a pasta longrun/ Teste rápido por ciclo: pytest -q -m "not real" Teste completo no final: pytest -q
Resultado: concluído no 1º ciclo (3 min). Verificação independente depois: hash dos testes intacto, sem valores fixos no código, 14 passed reproduzido e uma sessão nunca vista conferida.
Lista do templates/goal.md do kit.
Use a pasta que você criou na aula 1.
Preencha o goal.md com resultado, função, regressão, limite, os dois testes, restrições e portões humanos. Antes de qualquer trabalho, rode cada critério no terminal.
Pronto quando: cada critério tem um comando que roda agora; os de função falham antes do trabalho (se já passam, o critério não mede a tarefa) e o de limite já passa: git diff --exit-code -- tests/; echo $? → 0.
Num branch descartável (git switch -c ataque), faça a trapaça mais barata: apague um teste que falha, ou troque a função por um valor fixo. Rode os critérios de novo e volte com git switch -.
Pronto quando: para cada trapaça, pelo menos um critério falha; apagando teste, git diff --exit-code -- tests/; echo $? → 1.
Pergunta 1 de 4
O critério é "pytest -q → 0 falhas". Qual trapaça ele deixa passar?competência
Pergunta 2 de 4
No /goal do Claude Code, por que a condição tem de aparecer na saída?competência
Pergunta 3 de 4
Antes de qualquer trabalho, você rodou o critério de função e ele já passou. O que isso indica?
Pergunta 4 de 4
Qual camada responde "não mexeu onde não devia e não gastou o que não devia"?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.