Do Agile ao Agentic Operating Model · Capítulo 9 de 19 · 34 min
O que exigir antes de aprovar uma entrega feita por agente
Quinze itens, um dossiê anexado à entrega e três controles impedem que o agente fabrique a própria aprovação.
Este capítulo faz parte do curso gratuito Do Agile ao Agentic Operating Model.
Em boa parte das empresas, o mesmo agente escreve o código e escreve os testes que aprovam esse código, na mesma sessão. Nessa configuração o gate audita a si mesmo, e o verde deixa de significar qualquer coisa. O que está em jogo é a confiabilidade da própria aprovação: quando ela pode ser fabricada por quem está sendo aprovado, toda métrica de qualidade acima dela vira decoração. A decisão que cabe a você é exigir a separação entre quem faz e quem julga, e definir a partir de qual raio de dano ela passa a ser obrigatória. Dá para delegar o checklist, as ferramentas e o formato do dossiê. Não dá para delegar a regra de quem assina.
Glossário rápido
Definition of Done (definição de pronto)
Conjunto de critérios que o time considera suficiente para chamar uma tarefa de concluída. Nasceu num mundo em que o autor do código era humano, com julgamento conhecido e reputação em jogo.
Definition of Verified (definição de verificado)
Cunhagem deste curso. Promove o pronto declarado a verificado demonstrado, somando ao Done a evidência automatizada, a crítica adversarial e a revisão humana proporcional ao raio de dano.
Gate (portão de aprovação)
A regra que uma entrega precisa cumprir para ser aceita, e o ponto do processo em que essa regra é aplicada. Nesta aula, o gate é o checklist de quinze itens somado à decisão de quem assina.
Lei de Goodhart
Formulada pelo economista britânico Charles Goodhart: quando uma medida vira meta, ela deixa de ser boa medida. As pessoas, e os agentes, passam a otimizar o indicador em vez do resultado que ele deveria representar.
Montagem (build)
O passo em que o computador transforma o código escrito no programa que efetivamente roda. Se a montagem falha, nada mais adiante faz sentido, e por isso ela abre qualquer bateria de verificação.
Mutante sobrevivente
No teste de mutação, uma alteração deliberada feita no código que a bateria de testes deixou passar sem acusar nada. Mutante morto é a alteração que algum teste pegou. Sobrevivente alto significa testes que executam o código sem conferir o resultado.
Evidence Manifest (dossiê de evidências)
Formato proposto neste curso: resumo anexado à entrega com os comandos executados, os resultados obtidos, o que ficou sem cobertura e o plano de reversão.
Validação adversarial
Colocar um segundo agente para procurar falhas na entrega, com a tarefa de derrubá-la. Difere da segunda leitura amigável, que costuma confirmar o que o primeiro fez.
Specification gaming
Cumprir a letra do pedido sem cumprir o propósito dele. Em software, passar no teste sem resolver o problema.
Reward tampering
A forma grave do anterior: o modelo com acesso ao próprio processo de avaliação o altera para se aprovar.
Least privilege (privilégio mínimo)
Princípio de segurança segundo o qual cada participante recebe apenas a permissão necessária para a própria tarefa, e nada além dela.
Rollback e canary
Reversão planejada da mudança e implantação para uma fatia pequena do tráfego antes da liberação total.
TEVV
Sigla de test, evaluation, verification and validation. É o conjunto de processos de teste e validação que o NIST exige que sejam objetivos, repetíveis ou escaláveis, e documentados ao longo do ciclo de vida.
O Mapa de Provas mostrou o que a entrega precisa responder; falta a regra que diz quando ela pode ser aprovada. A definição de pronto (lista que diz quando a tarefa acabou, como a vistoria de saída da oficina) continua necessária: critérios de aceite, código integrado, documentação. Em ambiente com agentes (programas que trabalham sozinhos, como um terceirizado sem supervisor) ela deixa de bastar, porque foi desenhada para um mundo em que o autor do código era um humano cujo julgamento o time conhecia e cuja reputação estava em jogo. Com um autor probabilístico sem nenhuma das duas coisas, o pronto declarado precisa ser promovido a verificado demonstrado.
Numa linha de política de engenharia, a fórmula fica assim
Verificado = Pronto + evidência automatizada + validação adversarial + revisão humana proporcional ao raio de dano.
Cada termo da soma tem função própria e nenhum substitui outro. A evidência automatizada cobre o volume: são as camadas do Mapa de Provas que rodam na esteira, sem depender de alguém lembrar. A validação adversarial coloca outro agente para procurar falhas, com a tarefa explícita de derrubar a entrega. E a revisão humana proporcional ao raio de dano aloca o recurso mais caro do sistema, o julgamento sênior, apenas onde o alcance do estrago paga esse custo.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Os quinze itens e a evidência mínima de cada um
| # | Item | Evidência mínima |
|---|---|---|
| 1 | Especificação vinculada | Intenção, o que fica de fora, restrições e critérios de aceite |
| 2 | Plano de validação | O que será provado, e por quais testes ou ferramentas |
| 3 | Teste que falha primeiro | O comportamento desejado reprova antes da implementação existir |
| 4 | Ciclo vermelho, verde, refatoração | O teste escrito primeiro falha, o código o faz passar, a estrutura é limpa em seguida. Documentado para mudanças de resultado previsível |
| 5 | Montagem limpa | O código vira programa executável sem erro, e a esteira roda sem falhas |
| 6 | Verificação de tipos e lint | Sem regressões relevantes |
| 7 | Testes unitários | Menor unidade possível cobrindo o comportamento |
| 8 | Testes de integração e ponta a ponta | Fluxos críticos passando |
| 9 | Validação no navegador | Aplicação aberta e fluxo percorrido, quando aplicável |
| 10 | Teste de carga e performance | Comparação estatística, quando performance importa |
| 11 | Varredura de segurança e dependências | Vulnerabilidades, segredos e dependências avaliados |
| 12 | Revisão dos testes | Humano ou agente sênior avalia se os testes fazem sentido |
| 13 | Revisão adversarial | Outro agente tenta encontrar falhas na entrega |
| 14 | Conferência humana dirigida | Focada nos arquivos críticos e de maior raio de dano |
| 15 | Reversão e canary | Plano de reversão e implantação segura |
O item 12 merece destaque: teste gerado por agente é um resultado que ainda precisa ser julgado, e por isso entra na pauta de revisão. A aula sobre teste gerado por agente detalha o que procurar nele.
O laudo assinado por quem construiu
Ninguém compra um apartamento na planta aceitando, como prova de que a estrutura está boa, um laudo assinado pela própria construtora. A recusa nada tem a ver com suspeita de desonestidade: a construtora é parte interessada, e o mercado combinou há décadas que parte interessada não assegura a si mesma. Em software essa combinação ainda não foi feita. Na maioria dos times, quem produziu a entrega também produz a prova que a aprova, e ninguém acha isso estranho.
Onde a analogia para de valer: na obra, o laudo independente custa caro e demora semanas. No software, separar quem faz de quem julga custa uma linha de configuração de permissão. Quando essa separação não existe, alguém decidiu que ela não valia a linha, e limitação técnica não explica a decisão.
Squad de pagamentos, seis pessoas
Serviços financeiros
Dor
Uma regra nova de divisão de recebíveis, 480 linhas alteradas, entregues por agente. O time precisava decidir se aprovava ou não, e a única informação disponível era a afirmação do agente de que estava pronto.
Solução
A entrega passou pelos quinze itens, com o dossiê de evidências gerado automaticamente na esteira por um verificador em sessão separada, com modelo distinto do executor.
Resultado
Treze dos quinze itens presentes, o que dá 87% de completude de evidência. Falharam dois: a validação no navegador, porque a mudança é de retaguarda e ninguém abriu a tela de conciliação que consome o campo novo, e a conferência humana dirigida, porque o revisor aprovou por leitura de código sem abrir os dois arquivos de maior raio de dano. O gate reprovou, com razão: a regra é de recebível e a tela é onde o financeiro confere. O destravamento custou vinte minutos, uma gravação do fluxo e uma conferência dirigida a dois arquivos nomeados.
Cenário construído para fins didáticos. Números não correspondem a cliente específico.
Uma página basta para o dossiê que sai desse processo, e ele tem uma propriedade que interessa a quem aprova sem abrir código. A seção 1 lista os comandos crus, exatamente como saem da ferramenta, e serve de rastro para quem quiser repetir a verificação. A seção 2 traduz o que cada comando devolveu, e é por ela que um executivo lê o documento. Da seção 3 em diante o texto é todo em português de negócio: o que ficou sem cobertura, quem conferiu o quê, o risco que sobrou e como voltar atrás.
# Dossiê de evidências, PR #4812 (divisão de recebíveis)
Documento ilustrativo, construído para esta aula.
Gerado por: verificador (sessão separada, modelo distinto do executor)
Completude de evidência: 13/15
## 1. Comandos executados
- npm run build
- npm run typecheck
- npm run lint
- npm test -- --coverage
- npm run test:e2e -- --grep recebiveis
- npx stryker run --mutate src/financeiro/split.ts
- npm audit --audit-level=high
- gitleaks detect --no-banner
## 2. Resultados obtidos
- montagem: OK (42s)
- verificação de tipos: OK, 0 erros
- lint: OK, 3 avisos de formatação (não bloqueantes)
- testes: 318 passaram, 0 falharam, cobertura 86%
- ponta a ponta: 11 passaram
- mutação (split.ts): 41 mutantes, 38 mortos, 3 sobreviventes
- npm audit: 0 alto, 2 moderados (transitivos, sem correção publicada)
- gitleaks: nenhum segredo encontrado
## 3. Testes que rodaram, falharam e foram pulados
- Rodaram: unitários, integração e ponta a ponta do escopo de recebíveis
- Falharam: nenhum
- PULADO: ponta a ponta do fluxo de conciliação na tela
Justificativa: sem massa de dados para o campo novo.
RISCO ACEITO: a tela que o financeiro usa não foi exercitada.
## 4. Onde houve conferência humana dirigida
- Nenhuma. A entrega foi aprovada por leitura de código.
Arquivos de maior raio de dano NÃO abertos:
src/financeiro/split.ts e src/ledger/lancamento.ts
## 5. O que ficou sem cobertura
- Camada de produto: inexistente nesta entrega (item 9 ausente)
- Camada humana: inexistente nesta entrega (item 14 ausente)
- 3 mutantes sobreviventes em split.ts: verificações fracas nos
casos de arredondamento de centavos
## 6. Riscos residuais e plano de reversão
- Arredondamento de centavos pode divergir no fechamento diário
- Reversão: chave de funcionalidade SPLIT_V2, desligável sem nova implantação
- Canary: 5% dos recebíveis por 24h antes da liberação total
## Veredito
GATE REPROVA: itens 9 e 14 ausentes em mudança de raio de dano alto.
Destrava com: gravação do fluxo de conciliação na tela mais
conferência humana dirigida aos 2 arquivos nomeados na seção 4.Sexta-feira, quatro da tarde, véspera de lançamento, com campanha de marketing já comprada para segunda. O gate reprova em dois itens: o 10, teste de carga ausente, e o 13, revisão adversarial não executada.
O que você autoriza antes do fim do expediente?
Por baixo do checklist mora um ponto cego que, ignorado, o transforma em teatro de conformidade: ele pressupõe que a prova é honesta. Quando o mesmo agente escreve a implementação e os testes que a aprovam, o verde perde significado, porque a régua de sucesso pode ter sido ajustada por quem está sendo medido. Suponha um escritório de contabilidade de duas pessoas em que o agente ajusta a planilha de honorários e, na mesma sessão, escreve a conferência que aprova a planilha: o verde chega, e ninguém de fora conferiu nada.
A Anthropic deu nome ao fenômeno em pesquisa própria. Specification gaming é satisfazer a letra do pedido sem satisfazer o propósito. Reward tampering é a forma grave, em que o modelo com acesso ao próprio processo de avaliação o altera para hackear a recompensa. No estudo, o comportamento emergiu 45 vezes em 32.768 tentativas, sem nenhum treino explícito para isso, e o modelo apagou os próprios rastros em sete delas. A frequência é baixa e a lição executiva independe dela: quem pode editar o próprio critério de aprovação tende, eventualmente, a editá-lo.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Desde os anos setenta esse mecanismo tem nome. O economista britânico Charles Goodhart o descreveu assim: quando uma medida vira meta, ela deixa de medir bem, porque quem está sendo medido passa a otimizar o indicador em lugar do resultado que ele deveria representar. Por isso a definição de verificado só reduz risco quando vem blindada por três controles. Sem eles o dossiê de evidências disfarça o risco em vez de eliminá-lo, porque o próprio agente pode fabricar a prova que o gate (portão de aprovação, como a catraca que só abre com ingresso) exige.
- Testes fora do alcance de escrita do implementador: os arquivos de teste e o critério de aceite ficam bloqueados para o agente que implementa. Quem escreve a solução não edita a régua que a aprova. É o privilégio mínimo aplicado ao artefato mais sensível do processo, aquele que define o que conta como sucesso. O controle permite que o agente proponha testes; impede que ele os grave.
- Verificador em contexto separado: quem gera não julga o próprio trabalho. Modelos reconhecem e preferem o próprio resultado, e quanto melhor o modelo é em identificar um texto como tendo saído dele, mais forte fica essa preferência. O verificador roda em sessão própria e, de preferência, em modelo diferente do gerador.
- Achados identificados por conteúdo: um achado ancorado em "src/pagamento.ts, linha 142" evapora no primeiro rearranjo que mova a linha. Ancore cada achado em três coisas: a regra violada, o nome da função ou do campo afetado e a forma do problema. Assim ele sobrevive à renumeração e continua rastreável entre revisões.
Esses três controles endurecem justamente os itens 12 e 13 do checklist. A revisão dos testes só vale se o implementador não pôde escrever os testes que estão sendo revisados, e a revisão adversarial só é adversarial se o crítico não é o autor.
Uma ressalva sobre o segundo controle, porque ela costuma sumir na implementação. Trocar o juiz de modelo reduz a preferência pelo próprio texto e deixa intacto um problema mais fundo, que é saber se o juízo desse juiz vale alguma coisa.
Para medir isso, o caminho usual é colocar dois avaliadores diante dos mesmos casos e contar em quantos deles chegaram ao mesmo veredito. O número bruto engana, porque uma parte da coincidência acontece por acaso: dois avaliadores que chutassem concordariam em uma fatia dos casos sem entender nada do assunto. Existe uma correção estatística que desconta esse acaso, e a maior avaliação sistemática de juízes automáticos publicada até aqui, com 21 juízes de 9 fornecedores e cerca de 541 mil julgamentos, mostrou que aplicá-la derruba a concordância entre 33 e 41 pontos percentuais. Em linguagem de gestão: os números que circulam sobre confiabilidade de juiz automático estão inflados nessa ordem de grandeza.
Um segundo padrão apareceu no mesmo trabalho, e é ele que muda o desenho do controle. Os juízes repetiam o próprio veredito com muita consistência quando reexaminavam o mesmo caso e, ao mesmo tempo, mudavam de opinião conforme a ordem em que as respostas eram apresentadas. Consistência e validade medem coisas separadas: um verificador perfeitamente reprodutível consigo mesmo pode estar sistematicamente errado, e a reprodutibilidade dele não licencia confiança nenhuma. Daí sai uma regra de proporção. Mantenha a maior parte da superfície de verificação em checagens de resposta previsível, aquelas que devolvem sempre o mesmo resultado para a mesma entrada, e reserve o juízo por modelo para as dimensões que só se avaliam subjetivamente.
Três erros de implementação que esvaziam o gate, com a correção ao lado. (1) Gate que nasce bloqueando 100% das entregas morre em uma semana por rejeição do time: nasça medindo e aperte gradualmente. (2) Dossiê gerado pelo mesmo agente que implementou é autoavaliação com aparência de auditoria: verificador em sessão e modelo distintos. (3) Achado ancorado em arquivo e linha evapora no primeiro rearranjo e some da próxima revisão: ancore na regra violada mais o nome da função ou do campo afetado.
Verificação rápida
Sua organização adotou o checklist e a completude de evidência subiu de 8/15 para 14/15 em dois trimestres. O que ainda falta conferir antes de comemorar o número?
O pedido que você leva para a próxima revisão de entrega
Preencha os três campos e leve o texto pronto. Ele é pauta de reunião e registro da decisão.
Documento montado
Antes de aprovarmos a entrega "[QUAL ENTREGA]", peço três coisas por escrito. 1. O dossiê de evidências: quais comandos rodaram, o que cada um devolveu, o que ficou sem cobertura e qual é o plano de reversão. 2. A confirmação de que quem implementou não escreveu os testes que a aprovaram, e de que a revisão adversarial rodou em sessão separada. 3. A justificativa do nível de exigência aplicado, considerando que o raio de dano desta entrega é: [RAIO DE DANO SE ELA FALHAR]. Aprovação assinada por: [QUEM ASSINA A APROVAÇÃO]. Se algum dos três itens não existir, o estado da entrega permanece "em verificação", com prazo e responsável registrados aqui mesmo.
O que você digitar fica salvo neste navegador. Nada é enviado para servidor algum.
Não implante os quinze itens como gate bloqueante no primeiro dia. Rode o checklist como medição ao longo das próximas cinco entregas relevantes, conte quantos itens passam hoje e use o resultado como linha de base de completude de evidência, que é a métrica que a etapa de governar e medir leva ao painel do conselho. Gate que nasce bloqueando 100% das entregas morre em uma semana; gate que nasce medindo sobrevive e aperta gradualmente. Essa disciplina de medir antes de bloquear é também o que atende ao critério de TEVV do NIST AI Risk Management Framework 1.0, que exige processos de teste e validação objetivos, repetíveis ou escaláveis, seguidos e documentados ao longo do ciclo de vida do sistema.
Existe um argumento de sobrevivência institucional embaixo de tudo isso, e ele tem número. Numa amostra de 3.235 líderes de tecnologia e de negócio em 24 países, apenas 21% relataram modelo maduro de governança para agentes, enquanto 74% esperam usar agentes ao menos moderadamente até 2027. Adoção correndo na frente do controle é a descrição literal do estágio atual, e o dossiê de evidências é a peça mais barata de controle que uma organização consegue instalar sem reorganizar nada.
Com o dossiê, a economia da revisão também muda. O revisor deixa de reconstruir mentalmente o que o agente fez e passa a auditar um documento estruturado, julgando riscos e diferenças em minutos onde antes lia código por horas. É a materialização, no nível da entrega, do princípio de revisar por risco.
Descubra quanta prova você tem hoje
Pontue cada linha pela prova que existe agora, desconsiderando o que está no plano. Zero significa ausente, um significa em construção, dois significa operando.
0: ainda se aceita "ficou melhor?" como resposta. 1: as três dimensões aparecem em revisão, sem rito. 2: toda entrega relevante responde comportamento, risco e custo futuro por escrito.
0: não sei dizer quais camadas existem no processo. 1: tenho o mapa das dez camadas, sem plano. 2: camadas priorizadas por raio de dano, com dono e data por camada ausente.
0: pronto é declarado e aceito. 1: o checklist roda como medição, sem bloquear. 2: completude de evidência é métrica com linha de base e meta trimestral.
0: nunca auditei o gate contra manipulação. 1: identifiquei os vetores abertos. 2: testes fora do alcance do implementador, verificador em contexto separado e achados por conteúdo, os três em produção.
Comece pela reformulação da pergunta de aceite e pelo mapa das dez camadas. Enquanto o time aceitar declaração como conclusão, qualquer checklist implantado acima disso vira formulário.
Tente responder antes de rolar a página. (1) Você consegue enunciar os quatro termos da fórmula de verificado e dizer o que cada um cobre? (2) Sem consultar, quais dos três controles você recupera, e por que sem eles os itens 12 e 13 do checklist auditam a si mesmos? (3) Sabe explicar por que um achado ancorado em arquivo e linha evapora, e o que o torna durável? (4) Retomando a aula sobre as dez camadas de evidência: qual camada o item 10 do checklist instrumenta, e qual delas o item 9 instrumenta?
A pergunta que você leva para a próxima revisão de entrega tem uma linha: quem podia escrever os testes que aprovaram esta entrega? Se a resposta for "o mesmo agente que a implementou", nenhum número de completude de evidência acima disso significa alguma coisa, e a conversa sobre qualidade precisa recomeçar do zero. O critério de aceite é este: quem escreve a solução não edita a régua que a aprova, e quem julga roda em sessão separada. Tudo o mais no checklist é implementação, e implementação se delega.
Rode o gate como medição na próxima entrega relevante, sem bloquear nada.
- 01Escolha a próxima entrega relevante do seu time, gerada com agente, acima de 200 linhas alteradas.
- 02Percorra os quinze itens e marque cada um como presente, parcial ou ausente. Não conserte nada nesta rodada; apenas meça.
- 03Calcule a completude de evidência: itens presentes dividido por quinze.
- 04Submeta o gate às três perguntas de auditoria: o implementador podia escrever os testes que o aprovaram? o verificador rodou no mesmo contexto ou no mesmo modelo do gerador? os achados sobrevivem a um rearranjo que renumere as linhas?
- 05Escolha os três itens que sobem primeiro, nomeie o dono de cada um e crie, no mesmo movimento, o modelo de dossiê do seu repositório com as seis seções, definindo o ponto da esteira onde ele passa a ser gerado automaticamente.
Critérios de sucesso: confira se a rodada terminou com um número de linha de base no papel, em lugar de um palpite, e se os três itens priorizados foram escolhidos por raio de dano, cada um com dono, nome e data. Anote pelo menos um vetor aberto de manipulação do gate; se não encontrar nenhum, provavelmente auditou o gate com a régua que ele mesmo define. O modelo de dossiê está pronto quando atende ao critério do NIST: documentado, repetível e escalável.
Perguntas frequentes deste capítulo
Quinze itens não é gate demais?
Como impedir que o agente escreva os testes, se ele é quem tem contexto?
Qual é a diferença prática entre um teste que passa e uma prova que vale?
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoAgentes de IA Autônomos: Do Conceito à Produção
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo5 capítulos de “Do Agile ao Agentic Operating Model” usam conceitos apresentados em “Vídeo com IA: Claude Code, Codex e ElevenLabs”.
- CursoMCP para quem decidesugerido pelo grafo4 capítulos de “Do Agile ao Agentic Operating Model” usam conceitos apresentados em “MCP para quem decide”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Agentes de código para executivosVetar proposta que não nomeia o verificadorExaminar conexões de Vetar proposta que não nomeia o verificador
- Software e IA para executivosRevisar a entrega pela lista do que mudou linha a linhaExaminar conexões de Revisar a entrega pela lista do que mudou linha a linha
- Gestão de Projetos GEODefinir como conferir uma tarefa concluídaExaminar conexões de Definir como conferir uma tarefa concluída
- MCP com Chrome: Automação com IAOnde termina a leitura e começa a consequênciaExaminar conexões de Onde termina a leitura e começa a consequência
Voltar ao capítulo anterior: Descobrir as sete perguntas que o teste verde deixa sem resposta
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Do Agile ao Agentic Operating Model
- 07Nomear quem monta a prova da entrega e pode vetá-la
- 08Descobrir as sete perguntas que o teste verde deixa sem resposta
- 09O que exigir antes de aprovar uma entrega feita por agente
- 10O contrato que define sucesso antes de o agente escrever código
- 11Como provar que o agente continua certo depois de publicado