Uma especificação escrita para pessoas tolera ambiguidade, porque a pessoa pergunta. Um agente não pergunta: ele decide. O case mostra o que precisou mudar quando o leitor do requisito deixou de ser só humano.
O backlog em épicos e histórias, com critério de aceite em Gherkin, funcionava enquanto quem implementava era uma pessoa, porque a pessoa, diante de uma ambiguidade, pergunta. Quando parte da implementação passou a ser feita por um agente, três lacunas apareceram: critérios verificáveis em princípio mas que ninguém consegue executar, decisões deliberadas que moravam na memória de alguém e, o caso mais caro, a correção óbvia que está errada.
Um exemplo real e público: no Compras Públicas SC, a ingestão deixou de ser automática quando a fonte parou de publicar. A correção óbvia, de qualquer pessoa ou agente, seria religar o processo agendado. Isso recarregaria a base do zero e apagaria em silêncio o histórico de 2011 a 2020, que só existe ali. Nenhum teste falharia. O registro do porquê é o que impede esse erro.
select count(*), min(ano_assinatura) from stg_contratos; devolvia 104574 | 1994 antes e 79637 | 2016 depois. O critério mede o estado antes e depois da mudança, não só o resultado final: sem o antes, não há como provar que a mudança fez alguma coisa. O contraste com o Gherkin não é entre prosa e comando, é entre uma asserção que precisa de interpretação e uma que pode ser reprovada por uma máquina.O método está aberto em dois repositórios públicos, com 62 specs, mais as constituições e os documentos de arquitetura. O backlog original em Gherkin continua visível, arquivado no compras-publicas-sc, como registro da matéria-prima. O exemplo de aceite executável também está publicado, acompanhando a spec 034 e declarado como reconstruído.
Na spec 030, o aceite registrado mostra o formato funcionando: a ingestão manual levou a base de 95.508 para 104.574 registros, com 9.066 novos, 6.172 atualizados e 1.119 preservados por design, nunca apagados. A carga foi validada com o dbt build completo sem erro, 108 de 108 testes.
Não há métrica do método em si: nenhuma medida de retrabalho evitado ou de taxa de acerto do agente. Inventar um número aqui seria o contrário do que este case defende. O que existe é verificável: as specs estão abertas, os critérios estão escritos e qualquer um pode conferir se eles podem ser reprovados.
Uma especificação só está pronta quando algo pode reprová-la.