Consistência de código com IA:um padrão, 633 services

A consistência de código com IA vem de construir um padrão mestre e fazer a IA copiá-lo — sem nunca deixar que ela invente uma abordagem nova duas vezes. Uma plataforma real provou isso em escala: 633 services, cada um deles uma cópia idêntica de uma única base de 305 linhas, cada um deles construído pela IA. Repetição, não novidade, é o superpoder.

Se você não é técnico, esta talvez seja a lição mais contraintuitiva de construir com ajuda da IA. Fomos treinados para achar que a criatividade é a parte valiosa. Em software, é o contrário: as bases de código mais valiosas são as mais chatas. Aqui está a história, com os conceitos acima do código.

O erro que quase aconteceu

Janeiro de 2025. O banco de dados do FIKR Space está desenhado — multi-tenant desde o primeiro dia. Agora ele precisa de services. Muitos services.

A IA constrói o primeiro. Funciona. Ótimo. A IA constrói o segundo — e usa um padrão diferente. Tratamento de erros diferente, outro jeito de consultar o banco de dados. O terceiro service? Mais um padrão.

Para tudo. Porque a matemática dessa trajetória é brutal: seguindo assim, com 100 services você tem 100 padrões diferentes. Cada bug é corrigido de 100 jeitos diferentes. Refatorar fica impossível. Consistência vira sonho.

Não é a IA se comportando mal. Peça à IA para construir algo do zero e ela vai gerar uma solução perfeitamente razoável, na média da internet — uma solução perfeitamente razoável diferente a cada vez. A IA é uma improvisadora brilhante, e improviso é exatamente o que uma base de código não aguenta. Sem gestão, é assim que você escorrega para a armadilha do vibe coding.

O que um service realmente é (sem precisar de código)

Uma tradução rápida para leitores não técnicos. Um service é a camada entre o seu banco de dados e as suas telas. Quando um usuário clica em “salvar”, um service verifica se ele tem permissão, grava os dados no lugar certo, registra quem fez aquilo e dá o retorno — sucesso ou um erro útil.

Se o banco de dados é a fundação do seu produto e as telas são o rosto, os services são o sistema nervoso: todo sinal passa por eles. Cada funcionalidade do seu produto precisa de um — e é assim que uma plataforma séria acaba precisando de centenas. E todo service precisa responder às mesmas cinco perguntas: Este usuário pode fazer isso? De qual cliente são estes dados? O que acontece quando algo falha? Esta ação deve ser registrada? A entrada é segura?

Cinco perguntas, centenas de services. Essa repetição é ou o seu maior risco ou o seu maior ativo — dependendo de uma decisão.

Consistência de código com IA: a jogada do padrão mestre

A decisão: parar de construir services e construir primeiro o padrão. Uma base — 305 linhas de código — que responde às cinco perguntas uma única vez. Tratamento de erros. Filtro de multi-tenancy, para que cada cliente só veja os próprios dados. Checagem de permissões. Registro de auditoria. Sanitização da entrada. Cada resposta conquistada a duras penas, codificada uma única vez.

Depois, uma regra escrita em cada planta de funcionalidade entregue à IA: todo service estende a base. Sem exceções. (Essas plantas são PRPs — o funcionamento está em o método PRP.)

A partir desse momento, a IA parou de improvisar e começou a replicar. Peça um service novo e ela copia o esqueleto comprovado, preenche os detalhes e herda de graça todas as garantias de segurança. O primeiro service levou umas 2 horas — o tempo de construir a base direito. Cada um dos 632 seguintes levou de 15 a 30 minutos. Na plataforma inteira, isso dá umas 800 horas economizadas em comparação com construir cada um do zero.

O livroA Revolução do EUpreendedorLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem largar o emprego.Quero o livro →

Uma mudança, 633 atualizações

O retorno composto chega depois. Quando o registro de auditoria foi adicionado à base, os 633 services ganharam isso — na hora. Quando as mensagens de erro foram sanitizadas por segurança, os 633 services ganharam isso. Quando o tratamento de consultas melhorou, os 633 services ganharam isso. Uma mudança, 633 atualizações, zero edições manuais.

Isso sugere um teste simples para saber se sua arquitetura está funcionando. Chame de teste de escala: se você consegue adicionar uma capacidade à sua base e todos os services a herdam imediatamente, você acertou. Se teria de atualizar 633 arquivos à mão, você errou. O teste funciona tão bem com 6 services quanto com 633 — a única diferença é o quanto dói descobrir a resposta tarde.

Por que a repetição é o superpoder

Os números por trás do argumento de que o chato é bonito:

Olhe a linha do menor e do maior. O service mais simples tem 87 linhas; o mais complexo cuida de um fluxo inteiro de negociação de investimentos em 2.214 linhas. Trabalhos completamente diferentes — esqueleto idêntico. A complexidade varia; o padrão nunca.

O conceito para levar com você: a IA é uma replicadora perfeita. O que quer que você entregue a ela como referência, ela vai reproduzir com fidelidade e sem se cansar — o que significa que toda a alavanca está em o que você torna digno de ser replicado. Acerte um padrão, uma vez, e a IA vai carimbá-lo centenas de vezes sem cansaço, sem ego e sem atalhos. Não acerte nada antes, e a IA vai replicar o caos com o mesmo entusiasmo. A mesma lógica move a anatomia de um prompt de produção: aponte a IA para o seu melhor trabalho existente e deixe-a copiar.

A criatividade pertence ao seu produto, ao seu posicionamento, à sua oferta. Sua base de código deveria ser a coisa menos criativa que você tem.

12 semanasA sua carreira corporativa nunca foi o planoCandidate-se à Aceleradora de EUpreendedores.Candidatar-se →

Perguntas frequentes

O que é uma camada de services, em linguagem simples?

É a camada do meio do seu produto: o código que fica entre o banco de dados (onde os dados vivem) e a interface (o que os usuários veem). Toda ação relevante — salvar, buscar, apagar, checar permissões — passa por um service. É por isso que a consistência ali importa mais do que em qualquer outro lugar.

Eu preciso de 633 services?

Não — esse número reflete uma grande plataforma com vários produtos. Mas o princípio vale a partir do seu quinto service. A armadilha do padrão-diferente-a-cada-vez começa no segundo service, e o custo de corrigir a inconsistência cresce a cada service que você adiciona. Construa a base antes de construir a multidão.

Como faço a IA seguir meu padrão todas as vezes?

Duas jogadas. Primeiro, crie a base como um arquivo real no seu produto, não como uma ideia na sua cabeça. Segundo, referencie-a explicitamente em cada planta de funcionalidade, com uma regra sem exceções. A IA segue exemplos muito melhor do que descrições — o funcionamento de apontar a IA para arquivos de referência está na anatomia de um prompt de produção.

O que acontece se eu pular o padrão mestre?

Com dez services, você vai ter dez padrões diferentes: dez estilos de tratamento de erros, dez abordagens de segurança, dez jeitos de conversar com o banco de dados. Cada correção precisa ser redescoberta service por service, e uma limpeza de verdade acaba significando reescrever a maior parte do produto. É a versão estrutural da armadilha do vibe coding — progresso rápido agora, pago com juros depois.