Um parceiro, não um guardião.
Luke F. Walton · Fundador, Surmado · Maio de 2026
Escrevi ontem sobre por que a revisão de código não é mais só para engenheiros. Resumindo: profissionais de marketing, fundadores e CEOs estão lançando código agora, e ninguém construiu a camada de revisão pra eles.
Este post é a outra metade dessa história. Não o argumento. A decisão. Por que construímos o Surmado Code Review do jeito que construímos, para quem ele realmente é, e o que erramos antes de acertar.
Nós o construímos para nós mesmos primeiro
A Surmado começou como uma pequena equipe construindo ferramentas de IA para pequenas empresas. Estávamos fazendo vibe coding o tempo todo. Claude Code, Cursor, sessões longas onde a IA escrevia a maior parte do código e nós a direcionávamos. O resultado era rápido e os recursos eram reais.
Os problemas também eram reais. As convenções de nomenclatura variavam entre sessões. Verificações de autenticação desapareciam em rotas que não tínhamos tocado. Padrões de logging mudavam sem que ninguém pedisse. A IA produzia código que parecia correto, passava no build, e silenciosamente introduzia problemas que só notávamos depois.
Tentamos revisar tudo manualmente. Isso durou umas duas semanas. Os diffs eram grandes demais. O código parecia plausível demais. E tínhamos muitas outras coisas pra fazer.
Então construímos um revisor automatizado. Não para clientes, para nós. Ele rodava nos nossos próprios repositórios, contra nossos próprios padrões, em cada pull request que enviávamos. Iteramos nele por meses antes de abri-lo para qualquer pessoa.
Estamos na versão sete agora. Ele roda em 14 repositórios internos. Todo PR que nossa equipe envia passa pelo Surmado Code Review antes de um humano olhar pra ele.
As pessoas que continuávamos encontrando
Enquanto construíamos, algo continuava acontecendo. Conversávamos com fundadores, donos de agências, líderes de marketing. Pessoas que tinham começado a fazer vibe coding nos próprios sites, nas próprias ferramentas, nas próprias landing pages. Elas estavam animadas com o que conseguiam construir. Também estavam nervosas com o que talvez estivessem lançando.
A conversa era sempre alguma versão de: “Eu sei que deveria estar revisando esse código, mas não sei muito bem o que procurar, e não tenho um engenheiro pra perguntar.”
Essas não eram pessoas que precisavam de uma ferramenta de desenvolvimento complexa com arquivos de configuração YAML e integrações de pipeline de CI. Elas precisavam de algo que simplesmente funcionasse. Conectar ao GitHub, revisar os PRs delas, dizer o que está bom e o que precisa de ajuste, e fazer isso numa linguagem sobre a qual pudessem agir.
Foi para essas pessoas que construímos isso. Não exclusivamente. Engenheiros também usam, e funciona bem para eles. Mas todas as decisões de design partem de uma pergunta: alguém que começou a enviar código pro GitHub no mês passado conseguiria usar isso sem ajuda?
O que “mais fácil” realmente significa
Toda ferramenta de revisão de código diz que é fácil. Aqui está o que queremos dizer com isso.
Sem configuração. Você conecta sua conta do GitHub. É essa toda a configuração. Sem chaves de API, sem arquivos YAML, sem pipeline de CI para conectar. Dois cliques.
Seus padrões são uma conversa. A maioria das ferramentas pede que você escreva um arquivo de configuração ou escolha entre um menu de regras. Nós fazemos algo diferente. O Scout, nosso agente de IA, conversa com você. Você conta a ele como pensa sobre sua base de código da mesma forma que explicaria a um novo colega de equipe: “Usamos snake_case. Sempre verificamos autenticação em rotas de API. Nunca registramos PII em logs.” O Scout transforma essa conversa no seu STANDARDS.MD, o livro de regras contra o qual ele revisa cada PR. Se você não sabe quais deveriam ser seus padrões, tudo bem. Conte ao Scout o que você está construindo e com o que está preocupado. Ele preenche as lacunas.
Revisões que você consegue ler. Toda revisão inclui o que está bom (para você saber o que continuar fazendo), o que precisa de ajuste (vinculado aos seus padrões, específico, acionável), perguntas a considerar sobre casos extremos, e um resumo para revisor humano caso um colega de equipe venha a olhar. Ela também rastreia PII nos seus logs e verifica contratos de dados, se você os definiu. O resultado é estruturado para você saber exatamente onde olhar e o que fazer.
Sete idiomas. O produto, a interface de revisão e a documentação estão disponíveis em inglês, espanhol, francês, português, japonês, italiano e alemão. Se sua equipe ou seus clientes operam em mais de um idioma, seu revisor também opera.
Por que uma ferramenta focada, não uma IA de propósito geral
Essa é a pergunta que mais recebemos: “Por que eu não colaria meu código no ChatGPT?”
Você pode. E vai receber uma resposta diferente toda vez, porque um modelo de propósito geral revisando um PR não tem restrições, não tem padrões e não tem estrutura para o resultado. O problema não tem restrições, então o resultado é inconsistente.
Nós restringimos o problema deliberadamente. O Surmado Code Review foca em três coisas: o diff (o que de fato mudou), seu STANDARDS.MD (as regras que você definiu), e um formato de saída estruturado que organiza a revisão em categorias sobre as quais você pode agir. Essa restrição é o produto inteiro. É por isso que as revisões são consistentes, por que são úteis já na primeira leitura, e por que conseguimos fazer 100 revisões por $15 em vez de uma revisão por $15. Um problema focado custa menos para resolver bem.
Mas a escolha de design real é o que a ferramenta não faz. Algumas ferramentas de revisão de código reescrevem seu código ou aplicam correções automaticamente. Nós não fazemos isso. Você tem mais contexto do que qualquer IA sobre seu projeto, seus usuários e suas escolhas de trade-off. A revisão te dá tudo que você precisa para tomar boas decisões: o que está funcionando, o que precisa de ajuste, e as perguntas que valem a pena fazer antes de dar merge. Você pode copiar o resultado direto para sua IA de código e obter uma resposta sólida. Mas a melhor prática é ler a revisão você mesmo, decidir o que é relevante e usá-la para ancorar sua próxima rodada de mudanças.
Seu STANDARDS.MD não é algo que você escreve uma vez e esquece. É um documento vivo. Conforme você aprende mais sobre sua base de código, conforme descobre padrões que continuam dando errado, você o atualiza através de outra conversa com o Scout. Os padrões ficam mais precisos com o tempo, as revisões ficam mais direcionadas, e os problemas que o Scout pega ficam menores. Esse é o efeito cumulativo para o qual construímos.
Quanto custa
Essa abordagem focada também é o motivo pelo qual o preço funciona do jeito que funciona.
Usar o Claude diretamente para revisar um PR custa cerca de $15 por revisão. Está tudo bem se você está revisando um PR crítico por semana. Não está tudo bem se você está lançando código todos os dias.
O Surmado Code Review custa $15 por mês para 100 PRs. Não é erro de digitação. Cem revisões pelo preço de uma revisão do Claude. Sem preço por assento. Repositórios ilimitados. Se precisar de mais, pacotes adicionais de 100 custam $15 cada, e nunca expiram.
Também existe um nível gratuito. Dez PRs por mês, sem cartão de crédito. O suficiente para testar no seu repositório mais ativo e ver o que ele encontra.
Não definimos o preço para competir com outras ferramentas de revisão de código. Definimos para que o preço nunca seja o motivo de alguém pular a revisão. Se você é um fundador solo lançando código em três repositórios, $15 por mês deveria ser um item da fatura no qual você nunca pensa. É esse o objetivo.
O que não fazemos
Não armazenamos seu código. Enviamos o diff do PR e seu STANDARDS.MD ao provedor de IA no momento da revisão, geramos a revisão e descartamos o diff. Não registramos isso em log. Não treinamos modelos com isso. A única coisa que persiste é o comentário de revisão postado no seu PR, que fica no seu repositório do GitHub, sob seu controle.
Não substituímos revisores humanos. O Scout faz a primeira passada. Se você tem um colega de equipe que revisa seu código, ele vai gastar menos tempo caçando erros de digitação e violações de convenção e mais tempo em arquitetura e intenção. Na nossa própria equipe, o Scout reduziu o tempo até o fechamento em cerca de 3x porque o revisor humano pôde se concentrar no que realmente exigia julgamento.
Não reescrevemos seu código. Algumas ferramentas aplicam correções automaticamente ou enviam mudanças diretamente. Nós não fazemos isso. Se você quer uma IA que gera código, existem ótimas ferramentas para isso. O Surmado Code Review te dá uma avaliação honesta, de acordo com seus padrões, e confia em você para decidir o que fazer com ela. O revisor precisa ser um cérebro diferente do autor, mas o autor ainda toma a decisão final. Esse é todo o objetivo. Somos um parceiro, não um guardião.
A versão honesta
Somos uma empresa pequena. Construímos o Scout, o agente de IA por trás da Surmado, para profissionais de marketing e pequenas empresas. Esse é o nosso mundo. O Code Review saiu desse mundo, e isso aparece em cada decisão de design: a configuração conversacional, o resultado legível, o preço, o onboarding sem configuração. Entendemos profissionais de marketing porque somos profissionais de marketing que programam.
O que posso te dizer é isto: se você está fazendo vibe coding de um site de marketing, uma landing page, uma ferramenta interna, ou qualquer coisa que pessoas reais vão usar, e você não tem um revisor de código, você está voando sem rede. Não porque você é ruim nisso. Porque ninguém é bom o suficiente para revisar o próprio trabalho.
O nível gratuito existe para você ver por si mesmo. Conecte um repositório. Envie um PR. Leia a revisão. Depois decida.
Comece grátis em surmado.com/review →
Perguntas e Respostas
O que é o Surmado Code Review? O Surmado Code Review é um serviço automatizado de revisão de código para o GitHub. A cada envio para um pull request, o Scout, o agente de IA da Surmado, revisa o diff em relação ao documento STANDARDS.MD da equipe. As revisões incluem resultado estruturado: o que está bom, o que precisa de ajuste, perguntas a considerar, um resumo para revisor humano, rastreamento de PII e verificações de contrato de dados. A Surmado não armazena diffs de código nem os usa para treinamento de modelos. O serviço está disponível em inglês, espanhol, francês, português, japonês, italiano e alemão.
Para quem é o Surmado Code Review? O Surmado Code Review foi projetado para pequenas equipes (2 a 10 pessoas), desenvolvedores solo, fundadores que programam e não-engenheiros que lançam código através de ferramentas de vibe coding. A configuração não exige YAML, chaves de API nem configuração de pipeline de CI. Os padrões são definidos através de uma conversa com o Scout, em vez de um arquivo de configuração. Engenheiros também usam o produto para aplicar padrões de forma consistente entre repositórios.
Como o Surmado Code Review é diferente de outras ferramentas de revisão de código com IA? O Surmado Code Review restringe a revisão de IA a três entradas: o diff do pull request, o STANDARDS.MD da equipe e um formato de saída estruturado. Isso produz revisões consistentes e baseadas em padrões, em vez de sugestões amplas e sem restrições. A ferramenta não reescreve código nem aplica correções automaticamente. Ela fornece uma avaliação honesta e confia no desenvolvedor para tomar as decisões de trade-off. O preço é $15 por mês para 100 PRs, sem preço por assento, comparado a aproximadamente $15 por PR individual na revisão com o Claude Code. O Surmado Code Review é construído pela Surmado, uma plataforma gerenciada de presença web para pequenas empresas, que também oferece os produtos Site Audit e AI Visibility.