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

A consistência de código com IA vem de construir um padrão mestre e pôr a IA a copiá-lo — sem nunca a deixar inventar uma abordagem nova duas vezes. Uma plataforma real provou-o à escala: 633 serviços, cada um deles uma cópia idêntica de uma única base de 305 linhas, cada um deles construído pela IA. A repetição, e não a novidade, é o superpoder.

Se não és técnico, esta pode ser a lição mais contraintuitiva de construir com a ajuda da IA. Fomos treinados para pensar que a criatividade é a parte valiosa. No software, é o contrário: as bases de código mais valiosas são as mais aborrecidas. Eis a história, com os conceitos acima do código.

O erro que quase aconteceu

Janeiro de 2025. A base de dados do FIKR Space está desenhada — multi-tenant desde o primeiro dia. Agora precisa de serviços. Muitos serviços.

A IA constrói o primeiro. Funciona. Ótimo. A IA constrói o segundo — e usa um padrão diferente. Tratamento de erros diferente, forma diferente de consultar a base de dados. O terceiro serviço? Mais um padrão.

Paragem total. Porque as contas dessa trajetória são brutais: continua assim e, ao centésimo serviço, tens 100 padrões diferentes. Cada bug é corrigido de 100 formas diferentes. Refatorar torna-se impossível. A consistência torna-se um sonho.

Isto não é a IA a portar-se mal. Pede à IA que construa algo do zero e ela gera uma solução perfeitamente razoável, igual à média da internet — uma solução perfeitamente razoável diferente de cada vez. A IA é uma improvisadora brilhante, e a improvisação é exatamente aquilo a que uma base de código não sobrevive. Sem gestão, é assim que deslizas para a armadilha do vibe coding.

O que é realmente um serviço (sem código)

Uma tradução rápida para leitores não técnicos. Um serviço é a camada entre a tua base de dados e os teus ecrãs. Quando um utilizador carrega em «guardar», um serviço verifica se ele tem permissão, escreve os dados no sítio certo, regista quem o fez e responde — sucesso ou um erro útil.

Se a base de dados é a fundação do teu produto e os ecrãs são a sua cara, os serviços são o sistema nervoso: todos os sinais passam por eles. Cada funcionalidade do teu produto precisa de um — e é assim que uma plataforma séria acaba a precisar de centenas. E cada serviço tem de responder às mesmas cinco perguntas: este utilizador tem permissão para fazer isto? De que cliente são estes dados? O que acontece quando algo falha? Esta ação deve ficar registada? Os dados de entrada são seguros?

Cinco perguntas, centenas de serviços. Essa repetição é o teu maior risco ou o teu maior trunfo — depende de uma decisão.

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

A decisão: parar de construir serviços e construir primeiro o padrão. Uma base — 305 linhas de código — que responde às cinco perguntas de uma vez. Tratamento de erros. Filtragem multi-tenant, para que cada cliente só veja os seus próprios dados. Verificação de permissões. Registo de auditoria. Sanitização dos dados de entrada. Cada resposta conquistada a pulso, codificada uma única vez.

Depois, uma regra escrita em cada planta de funcionalidade entregue à IA: todos os serviços estendem a base. Sem exceções. (Essas plantas são PRPs — a mecânica está no método PRP.)

A partir desse momento, a IA deixou de improvisar e começou a replicar. Pede um serviço novo e ela copia o esqueleto comprovado, preenche os pormenores e herda gratuitamente todas as propriedades de segurança. O primeiro serviço levou cerca de 2 horas — o tempo de construir a base como deve ser. Cada um dos 632 seguintes levou 15–30 minutos. Em toda a plataforma, são cerca de 800 horas poupadas em comparação com construir cada um do zero.

O livroThe Solopreneur RevolutionLuis Gonçalves sobre como construir um negócio de EUpreendedor com IA sem deixar o emprego.Quero o livro →

Uma alteração, 633 atualizações

A recompensa composta chega mais tarde. Quando o registo de auditoria foi acrescentado à base, os 633 serviços receberam-no — de imediato. Quando as mensagens de erro foram sanitizadas por segurança, os 633 serviços receberam-nas. Quando o tratamento das consultas melhorou, os 633 serviços receberam a melhoria. Uma alteração, 633 atualizações, zero edições manuais.

Isto sugere um teste simples para saber se a tua arquitetura está a funcionar. Chama-lhe o teste da escala: se consegues acrescentar uma capacidade à tua base e todos os serviços a herdam de imediato, tiveste sucesso. Se tivesses de atualizar 633 ficheiros à mão, falhaste. O teste funciona tão bem com 6 serviços como com 633 — a única diferença é quanto dói descobrir a resposta tarde.

Porque é que a repetição é o superpoder

Os números por trás do argumento «aborrecido é bonito»:

Olha para a linha do mais pequeno e do maior. O serviço mais simples tem 87 linhas; o mais complexo gere todo um fluxo de negócios de investimento em 2.214 linhas. Trabalhos completamente diferentes — esqueleto idêntico. A complexidade varia; o padrão nunca.

Eis o conceito a levar contigo: a IA é uma replicadora perfeita. O que lhe deres como referência, ela reproduz com fidelidade e sem se cansar — o que significa que toda a alavancagem está naquilo que tornas digno de ser replicado. Acerta num padrão, uma vez, e a IA vai carimbá-lo centenas de vezes sem cansaço, ego nem atalhos. Não acertes em nada primeiro, e a IA vai replicar alegremente o caos. A mesma lógica move a anatomia de um prompt de produção: aponta a IA para o teu melhor trabalho existente e deixa-a copiar.

A criatividade pertence ao teu produto, ao teu posicionamento, à tua oferta. A tua base de código deve ser a coisa menos criativa que tens.

12 semanasA tua carreira corporativa nunca foi o planoCandidata-te ao Solopreneur Accelerator.Candidatar-me →

Perguntas frequentes

O que é uma camada de serviços, em linguagem simples?

É a camada do meio do teu produto: o código que fica entre a base de dados (onde vivem os dados) e a interface (o que os utilizadores veem). Cada ação com significado — guardar, ir buscar, apagar, verificar permissões — passa por um serviço. É por isso que a consistência aí importa mais do que em qualquer outro lado.

Preciso de 633 serviços?

Não — esse número reflete uma grande plataforma com vários produtos. Mas o princípio aplica-se a partir do teu quinto serviço. A armadilha de um padrão diferente de cada vez começa no segundo serviço, e o custo de corrigir a inconsistência cresce com cada serviço que acrescentas. Constrói a base antes de construíres a multidão.

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

Duas jogadas. Primeiro, cria a base como um ficheiro real no teu produto, não como uma ideia na tua cabeça. Segundo, refere-a explicitamente em cada planta de funcionalidade, com uma regra sem exceções. A IA segue exemplos muito melhor do que descrições — a mecânica de apontar a IA para ficheiros de referência está explicada na anatomia de um prompt de produção.

O que acontece se saltar o padrão mestre?

Ao fim de dez serviços, vais ter dez padrões diferentes: dez estilos de tratamento de erros, dez abordagens de segurança, dez formas de falar com a base de dados. Cada correção tem de ser redescoberta serviço a serviço, e uma limpeza como deve ser acaba por significar reescrever a maior parte do teu produto. É a versão estrutural da armadilha do vibe coding — progresso rápido agora, pago com juros mais tarde.