Conferindo se o Agente Realmente Obedeceu às Regras

Conferindo se o Agente Realmente Obedeceu às Regras — aula do módulo O Método em Qualquer Agente, na trilha Começando com Antigravity: do Zero ao Primeiro…

Leitura de aproximadamente 4 minutos.

Módulo: O Método em Qualquer Agente · Curso: Começando com Antigravity: do Zero ao Primeiro Resultado · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código

Conferindo se o Agente Realmente Obedeceu às Regras

O que você vai aprender

Por que "ele disse que seguiu as regras" não é evidência de nada.
Como construir um conferidor que lê o seu próprio arquivo de regras.
Os números medidos: 8 proibições, 4 obrigações, 7 scripts auditados em 1,46 s.
O que fazer quando o conferidor reprova um script que você considera correto.

1. O problema com regra escrita

Você escreveu o AGENTS.md. O agente diz que seguiu. Você acredita.

Esse é o ponto exato onde a coisa desanda. Não porque o agente minta de propósito, mas porque ele não tem como saber, com certeza, se a versão final do arquivo que ele escreveu ainda respeita tudo o que você pediu no início da conversa. Confirmar em prosa é barato; verificar é o que vale.

A boa notícia: verificar é rápido, e o próprio agente escreve o verificador.

2. O pedido

Escreva um script PowerShell conferir-regras.ps1 que leia o AGENTS.md desta pasta,

pegue os termos entre crases das seções "Proibido" e "Obrigatório", e confira cada arquivo

.ps1 da pasta contra eles. Termo proibido que aparecer em linha de comentário não conta

como uso. A exigência de -Aplicar vale só para script que move, apaga ou agenda alguma

coisa. Devolva código de saída 1 se houver qualquer violação.

Três detalhes desse pedido merecem atenção, porque cada um resolve um falso alarme previsível:

"Termos entre crases": o conferidor lê as regras do arquivo que você já escreveu, em

vez de ter a lista de proibições fixa dentro dele. Você muda a regra no AGENTS.md, o conferidor acompanha sozinho.

"Comentário não conta como uso": sem isso, um script que documenta *"este script não

usa Remove-Item"* seria reprovado pela própria documentação.

"Código de saída 1": transforma o conferidor em algo que pode ser encadeado em outros

fluxos, e não só lido por um humano.

3. Rodar


powershell -NoProfile -ExecutionPolicy Bypass -File .\conferir-regras.ps1 -Pasta .

Saída medida sobre os sete scripts desta trilha:


  Lidas  : 8 proibicao(oes), 4 obrigacao(oes)
  Scripts: 7 arquivo(s) .ps1
  OK    agendar-relatorio.ps1
  ...
  Nenhuma violacao. O agente respeitou o arquivo de regras.

Tempo total: 1,46 segundos. Código de saída 0.

4. O momento honesto: ele reprovou um script do próprio autor

Rodando o mesmo conferidor sobre o kit de scripts da primeira aula, a saída foi outra:


  FALHA empacotar-semente.ps1
          falta obrigatorio: -Aplicar
  1 violacao(oes). Nao aceite o trabalho antes de resolver.

Código de saída 1.

O script reprovado usa Remove-Item para limpar uma pasta temporária que ele mesmo acabou de criar. Olhando o caso, o script está certo: ele não toca em nada que seja seu. Quem está grossa demais é a regra — a regra literal não distingue "apagar a sua pasta" de "apagar a pasta de trabalho que eu mesmo criei há dois segundos". O humano distingue.

Isso não é o conferidor falhando. É ele fazendo o trabalho. Um verificador que nunca reclama de nada não está protegendo você de nada.

5. As duas saídas legítimas — e a ilegítima

Quando o conferidor reprova algo, você tem duas opções, e as duas são aceitáveis:

1. Mudar o script, se a regra estiver certa e o script estiver errado. 2. Mudar a regra, se o script estiver certo e a regra for grossa demais. Por exemplo: "a exigência de -Aplicar não vale quando o script apaga apenas arquivos que ele próprio criou na mesma execução".

O que você não pode fazer é ignorar em silêncio. Ignorar uma vez é decisão; ignorar sempre é hábito. No mês que vem, você ignora exatamente a reprovação que importava, com a mesma naturalidade.

Nesta trilha, a reprovação foi mantida de propósito, sem alterar o script nem a regra — justamente para que o exemplo continue visível.

6. Onde isso entra na sua rotina

O conferidor não precisa rodar toda hora. Ele vale nos dois momentos em que a atenção cai:

Antes de aceitar um lote grande de mudanças que você leu por cima.
Depois de uma sessão longa com o agente, quando você já perdeu o fio de tudo o que

foi alterado.

Um segundo e meio para saber se as suas regras continuam de pé é o melhor negócio desta trilha.

Resumo

Regra escrita não é regra cumprida; verificação em segundos resolve a diferença.
O conferidor lê o seu AGENTS.md, então regra nova é respeitada sem mexer no verificador.
Verificador que nunca reclama não protege ninguém — reprovação é o produto dele.
Diante de uma reprovação: mude o script ou mude a regra, mas decida conscientemente.

Conferindo se o Agente Realmente Obedeceu às Regras