Rever diffs, apanhar bugs antes do merge e reduzir dívida técnica.
Revisão de código é o momento em que alguém, ou alguma coisa, olha para uma alteração antes de ela entrar no ramo principal. Num projeto pequeno resolve-se com uma leitura rápida do diff. O problema aparece quando o repositório cresce, quando várias pessoas mexem nos mesmos ficheiros e quando parte do código passa a ser escrita por assistentes: o volume de alterações sobe e a atenção humana não acompanha.
Os componentes desta página dão ao Claude Code um papel definido nesse momento. Um agente lê o diff e devolve problemas com ficheiro e linha, outro procura apenas falhas de segurança, outro verifica se os testes cobrem mesmo o caminho novo. Há skills que publicam comentários em linha no pull request e automações que correm o linter a cada edição de ficheiro, antes de existir sequer uma revisão.
Comece pelo revisor de uso geral e pela automação de linting, que cobrem a maior parte dos casos com pouca configuração. Só depois acrescente revisores especializados, e apenas os que correspondem a riscos reais do seu projeto: segurança, arquitetura, contratos de API, cobertura de testes. Para código antigo, os agentes de refatoração e de dívida técnica são um caminho diferente, mais lento e mais deliberado.
21 componentes escolhidos à mão, de 4 ângulos diferentes.
Revisores que trabalham sobre um diff ou sobre um pull request. Cobrem o momento em que o código está pronto mas ainda não foi integrado.
Bom ponto de partida para quem ainda não tem nenhum revisor configurado: analisa as alterações submetidas num pull request e classifica problemas de qualidade, segurança e boas práticas.
Use este agente quando precisar de realizar revisões de código abrangentes, com foco na qualidade do código, vulnerabilidades de segurança e melhores
Para trabalho que ainda não saiu da sua máquina: lê o git diff e os ficheiros por seguir, devolvendo sugestões antes de existir sequer um commit.
Revisa as tuas alterações locais não submetidas na árvore de trabalho (git diff mais ficheiros não monitorizados) e devolve sugestões de melhoria acio
Quando a alteração já está num pull request do GitHub, publica os comentários diretamente nas linhas do diff através do gh, em vez de os deixar no terminal.
Revisa um pull request existente no GitHub e publica comentários de revisão em linha na respetiva diff. Usar quando as alterações estão num PR aberto
Concentra-se apenas em bugs e problemas críticos, com análise de causa raiz. Ajuda quando a revisão genérica devolve muitas notas de estilo e pouca substância.
Usa este agent ao rever alterações de código locais ou num pull request para identificar bugs e problemas críticos através de uma análise sistemática
Serve para quando desconfia que o modelo está a concordar demasiado com o código que acabou de escrever: usa personas de revisor hostis para expor pontos cegos partilhados com o autor.
Revisão de código adversarial que quebra a monocultura de autorrevisão. Usar quando quiser uma revisão genuinamente crítica de alterações recentes, an
Segunda opinião gerada por um modelo de outra família, em modo apenas de leitura. Faz sentido em diffs contestados ou em alterações sensíveis, onde vale a pena ter dois pareceres.
Executa uma revisão de código apenas de leitura baseada em Codex utilizando um modelo GPT SOTA. Utilizar como revisor de segunda opinião em conjunto c
Cada um destes revisores olha só para uma dimensão do código. Use-os quando a revisão genérica não chega, ou em paralelo num projeto com riscos concretos.
Olha para a alteração do ponto de vista da estrutura: camadas, princípios SOLID e coerência com os padrões existentes. Indicado para pull requests que mexem na organização do código.
Use este agente para rever código quanto à consistência e padrões arquiteturais. Especializa-se nos princípios SOLID, estratificação adequada e manute
Quando o diff toca em autenticação, entradas de utilizador ou dados sensíveis, aplica OWASP Top 10 e critérios de segurança empresarial em vez de comentários genéricos.
Especialista em revisão de código focada em segurança com OWASP Top 10, Zero Trust, segurança de LLMs e normas de segurança empresarial
Verifica se os testes que acompanham a alteração cobrem mesmo a funcionalidade nova e os casos-limite, em vez de apenas fazerem subir a percentagem de cobertura.
Usa este agent quando precisares de rever alterações de código locais ou um pull request quanto à qualidade e abrangência da cobertura de testes. Este
Vocacionado para alterações a APIs públicas, modelos de dados, esquemas de base de dados e definições de tipos, onde um erro de desenho fica caro de reverter mais tarde.
Usa este agent ao rever alterações de código locais ou pull requests para analisar a API, os modelos de dados e o design de tipos. Este agent deve ser
Se puser vários revisores a correr em paralelo, trata da parte aborrecida: remove achados duplicados, calibra a severidade e junta tudo num relatório único.
Coordena revisões de código paralelas em múltiplas dimensões de qualidade com desduplicação de descobertas, calibração de gravidade e relatórios conso
Aqui o objetivo não é aprovar ou rejeitar uma alteração, é melhorar código que já existe sem mudar aquilo que ele faz.
Pensado para código que ninguém quer tocar: métodos enormes, lógica duplicada, estrutura confusa. Reescreve preservando o comportamento existente.
Use quando precisar de transformar código mal estruturado, complexo ou duplicado em sistemas limpos e fáceis de manter, preservando todo o comportamen
Trabalha sobre o código alterado recentemente e reduz complexidade sem mudar funcionalidade. Encaixa bem como passo seguinte a uma revisão que apontou muita coisa pouco clara.
Simplifica e refina o código para clareza, consistência e manutenibilidade, preservando todas as funcionalidades. Foca-se em código recentemente modif
Para quem tem de decidir o que entra no próximo sprint: avalia a saúde do código e propõe uma ordem de refatoração, em vez de tratar a dívida como uma lista infinita.
Analista especialista em dívida técnica para a integridade do código, manutenibilidade e planeamento de refatorização estratégica. Utilize PROATIVAMEN
Depois de remover uma funcionalidade fica sempre resto: imports, funções e classes que já ninguém chama. Deteta-os em várias linguagens e remove-os com verificações de segurança.
Deteta e remove código não utilizado (importações, funções, classes) em múltiplas linguagens. Utilize PROATIVAMENTE após refatorização, ao remover fun
Feito para ramos escritos com ajuda de IA: compara com o ramo principal e retira comentários a mais, verificações defensivas desnecessárias e conversões de tipo para any.
Remova o código slop gerado por IA de um branch. Use ao limpar código gerado por IA, removendo comentários desnecessários, verificações defensivas ou
Automações, comandos e conetores que fazem o trabalho repetitivo acontecer sem ninguém se lembrar dele.
Corre ESLint, Pylint ou RuboCop logo a seguir a cada edição de ficheiro, por isso os erros de formatação e de estilo nunca chegam à revisão propriamente dita.
Executa automaticamente ferramentas de linting após modificações de ficheiros. Suporta ESLint para JavaScript/TypeScript, Pylint para Python e RuboCop
Trata da configuração inicial das ferramentas de análise estática num projeto que ainda não tem nenhuma, com deteção de linguagem e aplicação automática das regras.
Configurar ferramentas abrangentes de linting e análise de qualidade de código com aplicação automatizada
Uma lista de verificação para equipas que querem o mesmo critério em todas as revisões, com secções para funcionalidade, segurança, desempenho e manutenção.
Checklist abrangente para realizar revisões de código minuciosas que abrangem funcionalidade, segurança, desempenho e manutenibilidade
O outro lado da mesa: como avaliar comentários de revisão que parecem discutíveis, verificando antes de implementar em vez de aceitar tudo por deferência.
Usa ao receber feedback de revisão de código, antes de implementar sugestões, especialmente se o feedback parecer pouco claro ou tecnicamente question
Conetor para a API do Codacy, que dá ao Claude Code acesso aos relatórios de qualidade, cobertura e segurança que a plataforma já recolheu sobre o repositório.
Servidor MCP para a API da Codacy, permitindo o acesso a repositórios, ficheiros, qualidade, cobertura, segurança e mais.
Os agentes são ficheiros markdown que coloca em .claude/agents/ dentro do projeto, ou em ~/.claude/agents/ se os quiser em todos os repositórios. As skills seguem a mesma lógica em .claude/skills/ e são ativadas pela intenção do pedido, sem precisar de um comando. Os comandos ficam em .claude/commands/ e passam a estar disponíveis com barra. As automações vivem no ficheiro settings.json, na secção hooks, e correm sozinhas depois de cada edição. Os conetores MCP acrescentam-se à configuração de servidores MCP e pedem normalmente um token da plataforma. Depois de copiar qualquer um destes ficheiros, reinicie a sessão para que o Claude Code o reconheça.
O erro mais comum é instalar seis revisores e passar a receber relatórios de cem linhas que ninguém lê. Uma sequência que funciona: linting automático a cada gravação, revisor de uso geral sobre as alterações locais antes do commit, e só depois um ou dois revisores especializados escolhidos pelo que a alteração toca. Se o diff mexe em autenticação, chame o revisor de segurança. Se altera esquemas ou tipos públicos, chame o revisor de contratos. Quando correr mais do que dois em paralelo, use uma skill de consolidação para juntar achados repetidos e uniformizar a severidade, senão o mesmo problema aparece descrito de três maneiras diferentes.
Um revisor automático lê o que está no diff. Não sabe o que o cliente pediu, nem porque é que aquela função defensiva foi escrita há dois anos, nem se a funcionalidade faz sentido para o negócio. Tende também a produzir achados de baixo valor quando não lhe dá contexto suficiente do projeto, e a concordar com código que o próprio modelo escreveu, que é precisamente o motivo pelo qual existem revisores adversariais e de segunda opinião. Trate os relatórios como uma primeira passagem que apanha o óbvio e liberta atenção humana para as decisões que exigem contexto: desenho, prioridades e risco real.
Um agente corre numa sessão própria, com o seu contexto separado, e devolve um relatório no fim. É útil para revisões longas que não devem poluir a conversa principal. Uma skill carrega instruções na sessão atual quando o pedido corresponde à sua descrição, e é mais indicada para procedimentos curtos, como aplicar uma lista de verificação ou publicar comentários num pull request.
Componentes para escrever, correr e avaliar testes com o Claude Code.
Auditar código, encontrar vulnerabilidades e travar segredos antes do commit.
Encontrar a causa raiz: stack traces, logs, incidentes e fugas de memória.
Prompts e recursos curados de fontes internacionais, normalizados e categorizados: mais de 11 mil. Um robô do Doutor AI verifica as fontes todos os dias e traz o que há de novo.
Precisa de uma solução à medida?
Não sabe por onde começar a usar IA no seu negócio? Receba uma avaliação gratuita e um plano à medida - sem compromisso.
O Doutor AI dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe.
