Devin Review

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

• Devin webapp — Acesse app.devin.ai/review para ver seus PRs em aberto organizados por categoria (atribuídos a você, criados por você, revisão solicitada). Quando o Devin criar PRs, você verá um botão laranja “Review” no chat.
• Atalho de URL — Para qualquer link de PR do GitHub.com, substitua github.com por devinreview.com na URL. Para PRs privados, faça login no Devin primeiro ou use a CLI.
• GitHub Enterprise — Cole a URL completa do PR na página Devin Review em app.devin.ai/review. Todas as ofertas do GitHub (GitHub.com, Enterprise Server, Enterprise Cloud) têm os mesmos recursos.
• CLI — Execute npx devin-review {pr-url} a partir de um clone local do repositório. Veja CLI abaixo para mais detalhes.

• Detalhamento por usuário — Veja quantos ACUs de Review cada usuário consumiu no ciclo de cobrança atual e no anterior.
• Detalhamento por repositório — Veja o consumo de ACU de Review e o número de revisões por repositório, ajudando a identificar quais repositórios geram o maior custo de revisão.

• Merge — Faz o merge da PR usando a estratégia de merge configurada do repositório (merge commit, squash ou rebase). O botão de merge reflete o status atual de mesclagem da PR e as verificações obrigatórias.
• Close — Fecha a PR sem mesclá-la. Disponível no menu suspenso ao lado do botão de merge.
• Convert to draft — Converte uma PR aberta para o status de rascunho. Disponível no menu suspenso quando a PR está aberta e ainda não está como rascunho.
• Mark ready for review — Marca uma PR em rascunho como pronta para revisão. Um botão “Ready for review” aparece na barra de merge para PRs em rascunho.
• Auto-merge — Ativa ou desativa o auto-merge do GitHub no menu suspenso do botão de merge. Quando ativado, a PR será mesclada automaticamente assim que todas as verificações obrigatórias forem concluídas com sucesso. A barra de merge mostra o status atual do auto-merge, incluindo quem o ativou.

• Uma PR é aberta (não é rascunho)
• Novos commits são enviados (push) para uma PR
• Uma PR em rascunho é marcada como pronta para revisão
• Um usuário inscrito é adicionado como revisor ou responsável

• Revisão automática (padrão) — As revisões são acionadas em todos os eventos: PR aberta, novos commits enviados, rascunho marcado como pronto e revisor/responsável adicionado.
• Na criação da PR — As revisões só são acionadas quando uma PR é aberta pela primeira vez ou quando uma PR em rascunho é marcada como pronta para revisão. Envios posteriores de commits para a PR não acionam uma nova revisão.

1. Acesse Settings > Review
2. Clique em “Add myself (@yourusername)” para se inscrever

• Repositories — Adicione repositórios para revisar automaticamente TODOS os PRs nesse repositório. Use o menu suspenso para pesquisar e selecionar entre os repositórios conectados.
• Users — Visualize e gerencie todos os usuários inscritos em toda a organização. Adicione qualquer nome de usuário do GitHub à lista de revisão automática.
• Insert link in PR description — Quando ativado (padrão), Devin adiciona um link para a revisão na descrição do PR.

• Post GitHub PR checks — Quando ativado (padrão), Devin cria uma verificação de status de commit no PR para cada revisão. Isso permite que você veja os resultados da revisão diretamente na lista de verificações do seu PR.
• Bugs — Publique bugs (erros prováveis ou comportamento incorreto) como comentários no PR.
• flag (investigate) — Publique flags de investigação (problemas potenciais que merecem uma análise mais detalhada) como comentários no PR.
• flag (note) — Publique flags informativas (observações que talvez não exijam ação) como comentários no PR.

• Grave — Problemas com alta confiança que exigem atenção imediata
• Não grave — Problemas de menor gravidade que ainda devem ser revisados

• Investigar — O Bug Catcher identificou algo que merece sua atenção. Você deve revisar o código sinalizado por conta própria e verificar se há de fato um bug ou problema.
• Informativo — O Bug Catcher concluiu que o código está correto ou está explicando como algo funciona. Isso ajuda você a entender as mudanças de código sem exigir ação da sua parte.

1. Pelas configurações de revisão da PR (popover) — Em qualquer página de Devin Review, clique no ícone de configurações (três pontos) e ative a opção Enable Autofix. Essa opção aparece para PRs criadas pelo Devin.
2. Pelas configurações de revisão de PR embutida — Na visualização embutida do Devin Review dentro de uma sessão do Devin, abra o popover de configurações e ative a opção Enable Autofix.
3. Pelas configurações globais de Customization — Vá em Settings > Customization > Pull request settings > Autofix settings - bot comments e então:
   • Defina o modo como Respond to specific bots only e adicione devin-ai-integration[bot] à lista de permissões (allowlist), ou
   • Defina o modo como Respond to all bot comments.

• Apenas administradores da organização podem alterar essa configuração.
• Se o modo de comentários do bot estiver definido como Responder a todos os comentários do bot, o controle Auto-Fix aparecerá ativado, mas não poderá ser alterado nas configurações de revisão de PR. Use as configurações de Customization para modificar o modo de comentários do bot.
• Os comentários de resumo No Issues Found do Devin Review são sempre ignorados. Apenas comentários que apontam problemas de fato disparam o Auto-Fix.

cd path/to/repo
npx devin-review https://github.com/owner/repo/pull/123

1. Extração de diff baseada em Git — A CLI usa seu acesso Git local para obter a branch do PR e calcular o diff. Isso significa que você precisa ter acesso de leitura ao repositório na sua máquina.
2. Checkout em worktree isolada — A CLI cria um git worktree em um diretório em cache para fazer checkout da branch do PR. Isso mantém seu diretório de trabalho intocado — sem stash, sem troca de branch. A worktree é automaticamente limpa após a conclusão da revisão.
3. Diff enviado para os servidores do Devin — O diff calculado e o conteúdo dos arquivos são enviados para os servidores do Devin para análise.

• Acesso somente local por padrão — Quando você executa devin-review, ele inicia um servidor localhost na sua máquina que fornece um token seguro. Apenas processos na sua máquina local podem acessar esse token, o que significa que somente você pode ver a página de revisão enquanto estiver desconectado.
• Transferência para sua conta Devin — Se você fizer login em uma conta Devin que tenha acesso à organização do GitHub, a sessão de revisão é transferida para sua conta. Isso permite que você acesse a revisão de outros dispositivos e a compartilhe com colegas de equipe.

• Leitura de arquivos — Ler conteúdos de arquivos dentro do repositório
• Busca — Usar grep para padrões e glob para nomes de arquivos
• Comandos Bash — Apenas comandos de leitura, como ls, cat, pwd, file, head, tail, wc, find, tree, stat e du

• Bugs encontrados, sinalizações e anotações automatizadas sempre aparecem como o Devin bot.
• Quando um usuário escreve um comentário ou análise por meio do Devin Review, ele aparece usando a identidade do GitHub desse usuário.
• Quando um usuário pede para o agente de chat fazer uma alteração de código, o commit resultante é feito como o Devin bot.
• GitHub Suggested Changes segue o comportamento padrão do GitHub: qualquer revisor (incluindo Devin) pode deixar uma edição sugerida em um comentário de análise. Quando um usuário clica em “Apply suggestion”, o commit é atribuído àquele usuário, da mesma forma que no GitHub.
• Devin nunca criará commits ou comentários em nome de um usuário sem que o próprio usuário inicie explicitamente a ação.

• **/REVIEW.md
• **/AGENTS.md
• **/CLAUDE.md (sem diferenciar maiúsculas de minúsculas)
• **/CONTRIBUTING.md (sem diferenciar maiúsculas de minúsculas)
• .cursorrules
• .windsurfrules
• .cursor/rules
• *.rules
• *.mdc
• .coderabbit.yaml / .coderabbit.yml
• greptile.json

1. Vá para Settings > Review
2. Em Review Rules, digite um padrão glob de arquivo (por exemplo, docs/**/*.md)
3. Clique em Add

• Áreas da base de código que precisam de atenção extra
• Armadilhas comuns ou antipadrões a serem observados
• Convenções específicas do projeto que os revisores devem aplicar
• Arquivos ou diretórios que podem ser ignorados com segurança durante a revisão
• Considerações de segurança ou desempenho exclusivas do seu projeto

# Review Guidelines

## Critical Areas
- All changes to `src/auth/` must be reviewed for security implications.
- Database migration files should be checked for backward compatibility.

## Conventions
- API endpoints must include input validation and proper error handling.
- All public functions require TypeScript return types — do not use `any`.
- React components should use functional components with hooks, not class components.

## Ignore
- Auto-generated files in `src/generated/` do not need review.
- Lock files (package-lock.json, yarn.lock) can be skipped unless dependencies changed.

## Performance
- Flag any database queries inside loops.
- Watch for N+1 query patterns in API resolvers.