# Primeiro o mapa, depois a revisão

Canonical source: https://maguyva.ai/pt-br/blog/map-first-review-second

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Date: 2026-09-07 · Author: Maguyva Team

> Ancore o agente de código em um mapa do repo antes de ele escrever. Deixe o Greptile revisar o pull request depois. Uma dupla complementar, não uma troca.

Dois trabalhos diferentes ficam de cada lado de um pull request. Antes de o agente escrever, ele precisa de um mapa da árvore que está prestes a mudar. Depois que o agente abre um PR, algo deveria ler essa mudança contra o resto do sistema e deixar comentários sobre os quais um humano possa agir.

Esses trabalhos parecem semelhantes de longe porque ambos envolvem "entender a base de código". Não são o mesmo produto. Um responde "onde essa mudança deveria pousar?". O outro responde "o que esse diff quebrou que um linter linha a linha vai perder?". Misturá-los produz um primeiro rascunho pior e uma revisão mais barulhenta.

Este texto é um guia de fluxo de trabalho conjunto. O Maguyva é o mapa que o agente consulta primeiro. O Greptile é o agente de revisão que comenta o PR depois. A dupla é complementar por construção: o Maguyva não revisa pull requests, e o Greptile não substitui a camada de contexto que o agente usou para escrevê-los.

## Por que essa divisão é útil

Um agente de código que parte de priors de treinamento mais alguns arquivos colados vai inventar um caminho plausível e editá-lo. Essa é a falha do arquivo errado, e é um problema de recuperação. O Maguyva é uma camada de contexto de código MCP remota: recuperação semântica, estrutural (AST), por grafo/dependência e de texto, fundida em resultados ranqueados, mais busca de símbolos e recuperação de arquivos. Respostas fundamentadas voltam como `path/file.ext:line`, então você consegue rejeitar um erro antes que um patch exista. A afirmação continua modesta: menos edições alucinadas. O modelo ainda pode adivinhar. O primeiro passo só deixa de ser um chute.

O Greptile é um agente de revisão de código com IA. Em suas próprias palavras, ele revisa automaticamente todo pull request com compreensão completa da base de código, e posiciona isso contra linters tradicionais que verificam arquivos isoladamente em vez do sistema inteiro. A configuração consiste em instalar o app do GitHub ou GitLab e selecionar repositórios. Não há índice local para você operar. A hospedagem é o Greptile Cloud (eles declaram conformidade SOC 2 Tipo II, com relatório disponível sob solicitação), com uma opção auto-hospedada oferecida para empresas.

O fluxo numerado deles é: conectar e construir um grafo de dependências de cada função, classe e dependência; a cada pull request, analisar a mudança usando esse grafo completo do repo e publicar achados como comentários de PR com correções sugeridas, em cerca de três minutos; cada comentário pode passar o problema para um agente de código que a equipe já usa. Eles também declaram ler comentários humanos anteriores em PRs ao longo do tempo para aprender os padrões de código de uma equipe e reduzir sugestões ruidosas. O sistema de aprendizado deles, segundo declaram, precisa de 2 a 3 semanas para se adaptar.

Isso é revisão, não redação. O ponto forte do Greptile é o contexto de grafo completo do repo sobre a mudança que já pousou em um PR, seguido de um loop fechado que envia o achado para Claude Code, Codex, Conductor, Cursor ou Devin. O ponto forte do Maguyva é o mapa ranqueado que o agente consultou antes de essa mudança ser escrita. Use os dois. Não peça a nenhum dos dois para fazer o trabalho do outro.

Uma integração de produto de primeira parte Maguyva–Greptile não é declarada. Você não precisa de uma. O Maguyva fala com o agente via MCP. O Greptile fala com o GitHub ou GitLab pelo app deles. Eles se encontram no pull request. Sem script de cola, sem cron que canalize uma ferramenta para a outra. A dupla dispensa bash porque cada produto já ocupa a superfície que lhe pertence.

## O que isso não é

Isso não é uma demolição do Greptile. Não é uma página "troque de revisor". O Greptile lançou no Hacker News em 5 de março de 2024 como empresa da Y Combinator W24, e aquele tópico é como muita gente conheceu o produto pela primeira vez. Se foi assim que você os encontrou, fique com eles. Esta página é a metade da frente que falta nesse loop: ancorar o agente para que o PR que o Greptile vê já esteja mirando nos arquivos certos.

Os materiais de marketing do Greptile lideram com afirmações de velocidade de revisão e captura de bugs. Trate-as como afirmações do próprio Greptile, não como números verificados independentemente. Este rascunho não as repete como fatos.

A cobertura de linguagens é o mesmo tipo de honestidade. O Greptile enquadra o suporte como cobertura de todas as linguagens de programação em vez de uma lista enumerada; um número preciso não é informado. O Maguyva publica mais de 279 linguagens e tecnologias baseadas em texto, com uma divisão técnica (AST apoiado em parser versus só texto) no site quando a pergunta é técnica. São produtos diferentes fazendo afirmações diferentes. Não os misture.

Os preços do Greptile não são informados nas notas que este rascunho pode usar. Planos pagos existem; veja a página de preços deles. O Maguyva cobra por workspace, não por assento. Os planos começam grátis. A [página de preços](/pt-br/pricing) lista os níveis publicados se você precisar dos números de workspace.

## Fluxo de trabalho

Três etapas nomeadas. Execute-as nessa ordem. Não pule nenhuma na primeira vez que tentar a dupla.

### 1. Contexto do Maguyva

Indexe um repositório que você já conhece. Conecte o cliente MCP em que você já escreve — Claude Code, Cursor, Codex CLI, VS Code, Windsurf, ou outro cliente compatível com MCP. O Maguyva tem guias de configuração para 24 clientes MCP documentados e pode se conectar a outros clientes que suportem a configuração MCP padrão.

Faça uma pergunta que você consiga avaliar antes de qualquer um escrever uma linha. "Onde a expiração de sessão é tratada, e o que a chama?" é um primeiro movimento melhor que "conserta a autenticação". Exija citações. Abra os resultados `file.ext:line`. Siga o símbolo. Confirme a dependência que você está prestes a tocar.

O Maguyva expõe 11 ferramentas MCP voltadas ao cliente em busca, símbolos, análise de dependências, recuperação de arquivos, contexto de repositório e workflows utilitários determinísticos. Quatro modos de recuperação são fundidos em resultados ranqueados; `find_symbol` é uma ferramenta separada quando você já conhece o nome. Os [docs](/pt-br/docs) descrevem o caminho mais curto: começar grátis, indexar um repo que você já conhece, conectar o cliente, depois fazer uma pergunta que você consiga verificar.

Snapshots têm carimbo de tempo, então o agente consegue saber qual versão da árvore está lendo. O limite honesto é o trabalho local não sincronizado. Se a edição só existe em uma árvore de trabalho e não foi enviada, o mapa hospedado ainda não a contém. Arquivos de instrução (`CLAUDE.md`, `AGENTS.md`) continuam tendo seu lugar aqui, para convenções e o que não deve ser tocado. Não são um mapa vivo. Use-os para comportamento. Use o Maguyva para fatos.

Não deixe o agente abrir um PR antes que as citações sobrevivam ao contato com o repo. Essa barreira é todo o sentido desta etapa.

### 2. PR do agente

O mesmo agente agora escreve a mudança no cliente pelo qual você já paga. O Maguyva não é um editor nem um revisor. O agente continua produzindo o diff. Você continua abrindo o pull request no GitHub ou GitLab do jeito que já faz.

O que deveria ser diferente é o primeiro arquivo. O PR deveria nomear o handler que realmente implementa o comportamento, o chamador que vai quebrar, e o teste que vai falhar se a mudança estiver errada. Se a etapa 1 foi pulada, a etapa 3 vai gastar seus comentários em uma mudança que pousou no pacote errado. O Greptile ainda consegue encontrar problemas sistêmicos. Ele não deveria também ter que se recuperar de um caminho alucinado.

Mantenha o PR restrito. Um primeiro arquivo fundamentado não é licença para reescrever o módulo. A dupla complementar funciona quando o agente fez um trabalho com um mapa, e então pediu a um revisor que fizesse outro trabalho em um diff delimitado.

### 3. Revisão do Greptile

O Greptile já está conectado ao repositório pelo app do GitHub ou GitLab. No novo pull request, ele analisa a mudança usando o grafo completo do repo que construiu e publica achados como comentários com correções sugeridas. Os próprios materiais deles colocam essa passagem em cerca de três minutos.

Leia os comentários como você leria um colega de equipe cuidadoso: abra o local citado, decida se o achado é real, depois aja. Onde o Greptile oferece "Fix with your Agent", ele envia o problema — caminhos de arquivo, números de linha, código sugerido — para Claude Code, Codex, Conductor, Cursor ou Devin. "Fix All" envia todos os problemas da revisão de uma vez. Eles também entregam um MCP do Greptile e um plugin do Claude Code para essa transferência. O Maguyva não está nessa lista nomeada de destinos; essa ausência não é um problema. O Maguyva já fez seu trabalho na etapa 1. O agente de código que escreveu o PR é quem deveria receber o payload de correção.

Espere ruído nas primeiras 2 a 3 semanas enquanto o sistema de aprendizado do Greptile se adapta aos comentários que sua equipe realmente deixa. Esse é o cronograma declarado deles, não um defeito na dupla. A revisão humana continua no loop. O Greptile é a primeira passagem automatizada, não o botão de merge.

Se um comentário do Greptile aponta para um arquivo que o agente nunca consultou na etapa 1, esse é um sinal útil. Ou o mapa perdeu um chamador, ou o agente pulou uma citação. Corrija o rascunho contra o comentário. Não desative o revisor.

## Como manter o complemento honesto

- Maguyva primeiro, sempre. Uma revisão de um PR de arquivo errado ainda é uma revisão do arquivo errado.
- Greptile depois, sempre. Um rascunho bem citado ainda precisa de uma leitura do diff em escala de sistema inteiro.
- Não peça ao Maguyva para postar comentários de PR. Ele não faz isso.
- Não peça ao Greptile para ser a primeira camada de recuperação do agente enquanto ele ainda está escolhendo um caminho. Esse não é o trabalho para o qual o app deles no GitHub ou GitLab foi construído.
- Não invente um pipeline bash que "sincroniza" os dois. O PR é a interface.
- Verifique os dois lados de forma independente. Indexe um repo que você já conhece. Faça uma pergunta que você consiga verificar. Depois abra um PR pequeno e leia o que o Greptile realmente comenta.

O loop é comum assim que você o nomeia. Primeiro o mapa. Depois o PR do agente. Depois a revisão. Cada produto fica do lado do pull request em que é bom.

`// map first. review second. in that order.`