Contexto melhor, não maior: apontando um agente de programação para o código certo

Um desenvolvedor que corrige um bug não lê o repositório inteiro antes. Ele busca, segue referências, lê os poucos arquivos que importam, altera-os e roda os testes. Agentes de programação funcionam melhor do mesmo jeito. As ferramentas abaixo ajudam em etapas diferentes.

Comece pelo que você já tem

Antes de acrescentar qualquer coisa, use ferramentas determinísticas. git diff mostra o que mudou, git log e git blame mostram por quê, e o compilador, o linter e o executor de testes encontram erros com mais confiabilidade do que um modelo. Entregue ao modelo a saída dessas ferramentas, não a tarefa de adivinhá-la.

Empacote: repositórios pequenos e perguntas pontuais

• O Repomix (4,3) empacota um repositório em um único arquivo pronto para IA, com contagem de tokens, filtragem de segredos e compressão opcional. É o padrão para essa tarefa, até a base de código ficar maior que a janela de contexto do modelo.
• O code2prompt (3,8) faz o mesmo com templates e git diffs. O Repomix tem mais salvaguardas e lança versões com mais frequência.
• O Riflet (3,5) é um app desktop de apontar e clicar para quem não usa terminal. É um beta inicial de código fechado.

Busque: deixe o agente encontrar código pelo significado

• O Serena (4,4) dá aos agentes ferramentas no nível de símbolos, apoiadas em language servers.
• O Semble (4,1) e o grepai (3,7) fazem busca semântica de código localmente. Os dois são novos, e as alegações de economia de tokens vêm dos próprios autores.

Mapeie: relações entre arquivos

• O Graphify (4,1) constrói um grafo de conhecimento local que o agente consulta em vez de usar grep. Sua etapa de documentação pode, por padrão, enviar conteúdo a um modelo remoto.
• O code-review-graph (4,0) e o GitNexus (3,9) respondem a “o que esta mudança afeta?”. O GitNexus exige licença paga para uso comercial.
• O CodeGraph (4,1) responde ao mesmo tipo de pergunta por uma única ferramenta MCP, sob MIT, e atualiza o grafo conforme os arquivos mudam. A telemetria de uso fica ligada até você desligá-la.

Opções hospedadas

• O DeepWiki (4,0) escreve wikis grátis para repositórios públicos do GitHub e tem um servidor MCP. Bom para se orientar em um projeto desconhecido, mas suas páginas podem ficar atrás do código.
• O Greptile (4,1) revisa pull requests com base em um mapa de toda a base de código. Os modos de revisão mais profundos consomem mais créditos.
• O Sourcegraph (4,2) é a opção comprovada para busca em muitos repositórios, a partir de um contrato anual mínimo de US$ 16.000.

Qual usar

Projeto pequeno: git, ripgrep e Repomix bastam. Médio: acrescente um arquivo de instruções do projeto (CLAUDE.md ou AGENTS.md) e uma ferramenta de busca semântica. Grande ou com vários repositórios: ferramentas de símbolos, um grafo de código e busca em toda a organização. Seja qual for a escolha, um prompt curto que nomeia os arquivos relevantes, as restrições e a falha conhecida vale mais do que um enorme.