Ideia principal

Aquilo de que um produto é feito — seus objetos, os estados que eles atravessam, o que é proibido e a partir de quando — vive no código e na cabeça de algumas pessoas. Esse arranjo funcionava enquanto dava para bater na porta do colega certo: a regra que faltava se obtinha em três minutos, e ninguém precisava escrevê-la.

Um agente a quem se confia uma evolução não bate em porta nenhuma. Ele recebe algumas frases de instrução e o que consegue ler no código; todo o resto, ele preenche — de forma plausível, coerente e às vezes falsa. Ele não avisa que preencheu, porque não sabe que fez isso.

Daí uma medida inesperada: a diferença entre o que a gente queria e o que a gente recebe é exatamente a parte do modelo mental que não tinha sido escrita. Cada retrabalho depois de uma evolução delegada aponta uma regra que ficou só na fala.

Por que isso importa

Isso muda a justificativa para escrever o modelo do produto. O argumento clássico — a memória da empresa, a saída de um especialista — sempre perdeu para a urgência, porque o prazo dele é distante. Aqui o prazo é a semana que vem: o que não está escrito se paga em retrabalhos imediatos, visíveis, atribuíveis.

Isso também dá um instrumento de diagnóstico de graça. Em vez de adivinhar o que seria preciso documentar, você deixa um agente trabalhar e escreve o que ele inventou. A lista de buracos se fabrica sozinha.

E o tamanho do artefato conta: algumas centenas de fichas de objetos cabem num contexto onde milhares de arquivos de código não cabem — o agente lê o necessário em vez de vasculhar.

Nuances e limites

Escrever o modelo não deixa o agente mais inteligente: apenas o impede de inventar onde existe uma regra. Nas áreas em que nenhuma regra jamais foi estabelecida, ele vai continuar preenchendo, e aí o que falta é uma decisão de produto, não uma linha de documentação.

Nada disso está medido enquanto não se compararem dois lotes de pedidos, tratados com e sem o repositório em contexto: o mecanismo é sólido, o ganho continua sendo uma expectativa.

Questões em aberto

• Como reconhecer, numa saída de agente, o que foi preenchido — sem reler a área em questão com a mesma atenção que se teria ao escrevê-la você mesmo?