Ideia principal

Uma API que devolve duzentos itens e uma API que devolve trinta mil pedem dois projetos diferentes: a primeira carrega e exibe, a segunda impõe paginação, filtragem no servidor e estratégia de carregamento. Nada no código distingue os dois casos, e nada num conjunto de dados de desenvolvimento também.

Um assistente como o Claude Code que não recebeu nenhuma informação sobre os volumes reais produz, então, a solução mais direta: carregar tudo, mandar tudo para a página, filtrar tudo no front. Em desenvolvimento, com algumas dezenas de linhas, isso funciona — e é justamente esse o problema, porque a validação passa.

A falha que vem depois não parece uma falha. Não há erro vermelho no console: há uma página que leva oito segundos para responder, um navegador que trava, um comportamento que você atribui à rede. Um defeito silencioso não é só mais difícil de corrigir, é mais difícil de atribuir — e para quem não tem cultura técnica, ele nem sequer é identificável como defeito.

Por que isso importa

Isso aponta uma categoria de informação que o assistente não consegue deduzir e que é preciso lhe dar: as ordens de grandeza do real. Nem a leitura do código existente, nem o conjunto de teste, nem a formulação do pedido contêm isso.

Isso também diz o que um conjunto de dados de desenvolvimento nunca prova. Uma homologação feita sobre dados de teste atesta que o comportamento está correto, não que ele se sustenta — e são duas propriedades validadas no mesmo momento, na mesma tela, sem que nada as separe.

Nuances e limites

O mecanismo não é exclusivo dos assistentes: desenvolvedores sempre entregaram consultas que desabam em produção. O que muda é a frequência, já que ninguém se faz a pergunta no momento em que o código aparece em alguns segundos.

E declarar o volume nem sempre basta: certas restrições só se descobrem em produção, sobre distribuições de dados que nenhuma estimativa antecipava.

Questões em aberto

• Quais outras restrições do real são, como o volume, invisíveis no código e ausentes do conjunto de teste — a latência das dependências, a concorrência de acesso, o tamanho dos anexos?