Todo mundo que já pediu código a um modelo de linguagem conhece a sensação: em trinta segundos aparece uma tela inteira, com formulário, validação e até comentário simpático. Em trinta minutos aparecem os problemas. Um campo que aceita qualquer coisa, uma chave de acesso esquecida no meio do arquivo, uma segunda forma de fazer o que o projeto já fazia de outro jeito.
O modelo não errou por falta de inteligência. Errou por falta de chão. Ninguém disse a ele como aquela casa faz as coisas.
O modelo é o motor, não o carro
Na Kabran, a IA escreve a maior parte do código. Isso não é segredo nem slogan: é o jeito como a fábrica foi desenhada desde o primeiro dia. Mas a pergunta que a gente se faz nunca é “o modelo consegue?”. É “o que acontece quando ele consegue do jeito errado?”.
A resposta é o que chamamos de harness: o conjunto de padrões, verificações e limites dentro do qual cada agente trabalha. O motor pode ser o mais potente do mundo. Sem direção, freio e estrada, ele só chega mais rápido ao lugar errado.
Um agente sem padrão entrega rápido. Um agente com padrão entrega o que dá para manter.
O que um padrão diz, na prática
Um padrão, para nós, não é um documento bonito que ninguém lê. É uma instrução curta, verificável e carregada no momento em que o agente precisa dela. Alguns exemplos reais do tipo de coisa que está escrita:
- nenhum valor que muda entre ambientes fica cravado no código — endereço, porta, chave, nada;
- o diff entrega o que foi pedido e só isso; refatoração que ninguém pediu não pega carona;
- toda tela nasce com os estados de carregando e de erro, não só com o caminho feliz;
- se o repositório já tem um jeito de fazer algo, não se inventa um segundo.
Nenhuma dessas regras é genial. O valor está em que elas valem sempre, para todo agente, em todo projeto — inclusive às três da manhã, inclusive no décimo pedido do dia.
Dois portões que ninguém atravessa sem passar
Escrever o padrão é metade do trabalho. A outra metade é garantir que ele foi seguido sem depender de boa vontade. Por isso todo trabalho passa por dois portões antes de seguir adiante.
O primeiro é de qualidade: tipos conferidos, testes rodando, o comando que valida localmente é o mesmo que roda na esteira. O segundo é de segurança: varredura de segredo antes de cada commit, dependências conferidas, nada de credencial no histórico.
Um portão que falha fecha. Não existe “passa só dessa vez”. Se a verificação não conseguiu verificar, ela reprova — silêncio nunca conta como sucesso.
Por que isso importa para quem contrata
Você não está comprando linhas de código. Está comprando a confiança de que o produto vai continuar de pé daqui a seis meses, quando alguém precisar mudar uma coisa pequena sem quebrar três grandes.
A velocidade da IA é o que torna a Kabran possível. Os padrões são o que tornam a Kabran confiável. Um sem o outro seria só mais uma demonstração bonita que não aguenta o primeiro cliente de verdade.
O trilho também evolui
Cada erro que escapa vira uma pergunta: que padrão teria impedido isso? Às vezes a resposta é uma linha nova nas instruções. Às vezes é uma verificação automática, que é sempre melhor que uma linha de texto. E às vezes a resposta é que o padrão antigo estava errado, e ele sai.
É por isso que a gente escreve este blog. Os trilhos que construímos são a parte mais importante da fábrica — e a mais interessante de contar.