Skip to main content
Login

Cinco Claudes, cinco implementações. Qual é a sua?

A IA não tornou o code review obsoleto. Tornou-o o gargalo. Veja por que o gosto do seu time é o moat, e como codificá-lo.

Execute cinco instâncias do Claude Code no mesmo ticket. Você obtém cinco implementações funcionando. Todas passam nos testes. Todas resolvem o problema. Nenhuma se parece com o código que seu time teria escrito há seis meses.

Esse é o novo ponto de partida. O espaço de probabilidade de implementações válidas simplesmente explodiu, e não vai colapsar sozinho.


A IA não tornou o code review obsoleto. Tornou-o o gargalo.

Por dez anos, a geração era o limitante e a revisão era a limpeza. A tarde de um engenheiro sênior era 30% escrevendo código, 70% revisando o que os outros escreviam. O gargalo era a velocidade de pensamento humano.

Isso se inverteu. A geração ficou praticamente gratuita. Um dev solo com Claude Code ou Cursor pode produzir em uma semana mais código do que um time de cinco pessoas produzia em um ano.

O gargalo mudou. Agora é: qual dessas cinco implementações corretas realmente pertence ao nosso código?

Essa pergunta não tem uma resposta de modelo. Tem uma resposta de time. O gosto acumulado do time é o que separa “código que funciona” de “código que pertence aqui”. Como você nomeia coisas. Como estrutura módulos. O que você se recusa a importar. Quando faz early exit. Como escreve testes.

Sem isso, cada PR vira um cara ou coroa entre opções plausíveis.


Seu gosto é o moat. Codifique-o.

É aqui que a maioria dos times trava. O gosto existe. Está na cabeça de alguns engenheiros, nos comentários de PR, no Slack, naquele olhar de reprovação numa terça à tarde. É real, e é o que diferencia um código que acumula valor de um que deriva para o caos.

Mas não está codificado em nenhum lugar que uma máquina consiga ler. Então agentes não conseguem seguir. Novos membros não conseguem seguir. Nem os próprios seniors conseguem aplicar isso de forma consistente, porque estão cansados, de plantão ou em reunião quando o PR chega.

A maioria dos times já tem um CLAUDE.md ou .cursorrules. Isso é um contrato de escrita. Ele diz ao agente o que produzir. Mas existe uma assimetria: não existe um contrato de revisão. Nenhum arquivo diz, para humano ou máquina, o que é aceitável para dar merge.

Esse arquivo é o STANDARDS.md. Markdown simples, dentro do repo, versionado com o código. As decisões acumuladas do time, explícitas. Não boas práticas genéricas. Suas opiniões específicas sobre como vocês constroem.

Nada disso é novo. Kleppmann, em Designing Data-Intensive Applications, mostra que sistemas acumulam valor quando seus contratos são explícitos e verificáveis por máquina. Esquema, não intuição. STANDARDS.md é essa mesma disciplina um nível acima. O contrato deixa de ser entre serviços e passa a ser entre o PR e o gosto do time.

Quando esse arquivo existe, três coisas acontecem.

Agentes geram código seguindo esse padrão. Seu gosto restringe o espaço de probabilidade antes de o código ser escrito.

Todo PR é revisado automaticamente contra ele, seja o autor humano ou agente. Sem drift, sem exceções, sem “pegamos no próximo sprint”.

Novos membros leem um único documento e absorvem a visão do time em uma tarde.

STANDARDS.md não é documentação. É a função de colapso. Ela reduz o espaço de possibilidades à sua implementação.


Aceleramos nosso time 3× fazendo a IA revisar todo PR contra nossos padrões.

Batemos exatamente nesse problema há três meses. Construímos o Surmado Code Review primeiro para uso interno. Ferramenta interna, v7. Rodando em 14 repositórios a cada commit.

Nossos padrões vivem em um STANDARDS.md por repo. O Scout lê isso, lê o diff e diz ao revisor humano: o que está bom, o que precisa melhorar, onde focar e quais premissas o PR está assumindo.

O ganho de 3× é no tempo até o merge nos 14 repos. Nossos PRs não ficam parados. Avançam.

Isso não veio do bot fazendo a revisão. Veio do bot reduzindo o ruído para que os humanos focassem no que importa. O sênior parou de repetir as mesmas cinco observações em todo PR. O júnior parou de adivinhar convenções. Os PRs gerados por agentes pararam de sair do padrão do time.

Se você ainda não tem STANDARDS.md, o Scout escreve com você. Dois cliques para instalar. O Scout te entrevista sobre stack, convenções, postura de testes e as decisões arquiteturais que você já tomou.

Onde você tem opiniões, o Scout as registra. Onde ainda não tem, o Scout propõe defaults que você pode aceitar, editar ou sobrescrever. Se você é um vibe coder que nunca precisou articular seus padrões, o Scout estrutura o raciocínio e traz à tona as perguntas que você ainda não pensou em fazer.

As opiniões continuam sendo suas. A estrutura é a mesma que usamos internamente nos nossos STANDARDS.md. O tipo de disciplina de padrões que um time maior leva semanas para consensuar, você tem rodando hoje à tarde.

Meu time de desenvolvimento me obrigou a lançar. Estavam cansados de dizer para amigos fundadores que não, eles não podiam ter acesso, que era interno. Então transformamos em produto.


Sobre o seu código

Nós não armazenamos. Não treinamos com ele. Não lemos seu repositório inteiro.

O Scout roda sobre modelos de fronteira da Anthropic e da OpenAI. Cada revisão de PR envia apenas o diff para essas APIs, sob os acordos padrão. Sem retenção. Sem treinamento. Nada sobre o seu código persiste nos nossos sistemas depois que a revisão termina.

Leia a política de privacidade e os termos completos. Tudo está documentado.


Para que isso realmente serve

O pitch que a maioria das ferramentas de IA faz é: o modelo substitui o humano. Esse enquadramento está errado desde o princípio, e está especialmente errado agora.

A geração com IA está tornando os times mais rápidos, mas também está fazendo as bases de código derivarem mais rápido. O acelerador e a entropia vêm do mesmo lugar. Os times que avançam são os que descobriram como elevar o julgamento humano para acompanhar a velocidade da máquina, não os que o substituíram.

Surmado Code Review não é um revisor autônomo. É um multiplicador do gosto do time. Seus padrões, aplicados a cada PR, cada push, cada execução de agente. Humanos continuam fazendo o trabalho humano: decidir quais são os padrões, tomar as decisões arquiteturais, mentorar o time, conhecer o negócio. O bot faz a parte que estava esgotando seus seniors: identificar desvios de decisões já tomadas.

O futuro da IA no código não é agentes substituindo engenheiros. É o gosto do engenheiro, codificado uma vez, aplicado em todos os lugares, em velocidade de máquina. Os times que entenderem isso primeiro vão parecer irreconhecíveis para os que não entenderam. Não porque os devs deles sejam mais inteligentes. Porque o gosto deles está operando em cada linha de código, incluindo as que não foram escritas por eles.

Como tudo o que construímos na Surmado, isso coloca o humano no centro e potencializa o agente. Seu gosto, amplificado.


Teste no seu próximo PR

Surmado Code Review. Dois cliques para instalar. US$15/mês por 100 PRs. Sem cobrança por usuário. Zero retenção dos seus diffs. Feito para devs solo e times pequenos que se movem rápido. Não feito para enterprise.

Instalar Surmado Code Review ou ler como construímos.

Leituras relacionadas:

Pronto para agir?

O Scout pesquisa sua marca em ~15 minutos.