# Mapa do projeto

URL: https://agentvera.dev/pt/features/project-map/ · Plano: Grátis

Quando um agente começa uma tarefa nova, normalmente ele faz um grep primeiro e depois lê os arquivos um por um. O mapa do projeto encurta essa busca: o AgentVera indexa no seu computador os símbolos, imports e arquivos que mudam juntos no projeto, e os agentes pedem às ferramentas MCP agentvera-map os arquivos relevantes, quem os usa e os testes deles.

**O que é indexado.** O mapa é montado com tree-sitter. Em arquivos TypeScript, TSX, JavaScript, Python e Go, funções, classes, métodos, interfaces, tipos, enums e constantes são extraídos com seus intervalos de linhas, assinaturas e a primeira frase da documentação. Cerca de 30 outras linguagens, como Rust, Java, PHP e Ruby, entram no mapa pelo caminho do arquivo.

- Os imports são resolvidos para arquivos do projeto; os testes são ligados aos arquivos que importam e aos arquivos-fonte com nomes correspondentes.
- Mudam juntos: arquivos que mudaram juntos em pelo menos dois dos últimos 500 commits formam um par; commits que mexem em mais de 40 arquivos são ignorados.
- Os arquivos são encontrados com git ls-files e o .gitignore é respeitado; pastas como node_modules, dist e build, arquivos acima de 1 MB e arquivos gerados ou minificados ficam de fora.
- Em repositórios com mais de 20.000 arquivos, só as pastas de código-fonte (src, lib, app, packages/*/src…) são indexadas.

**As ferramentas agentvera-map.** O mapa é adicionado ao agente como um servidor MCP. As instruções dele dizem ao agente para começar uma tarefa com map_related, consultar map_outline antes de ler um arquivo e map_usages antes de mudar código. As instruções de um agente novo também recebem um resumo curto dos módulos, entry points e comando de teste do projeto.

- map_related: os arquivos que uma tarefa mais provavelmente envolve, ordenados e com os motivos. Palavras de tarefa em turco (sepet, kupon, ödeme…) também casam com os nomes em inglês no código.
- map_outline: os símbolos de um arquivo com intervalos de linhas, quantos arquivos o importam e os testes dele.
- map_usages: onde um símbolo é definido e chamado, os arquivos que o importam e os testes; para um arquivo, quem o importa e quem importa esses.
- map_find: busca aproximada em nomes de símbolos e arquivos, com tipo, arquivo:linha e assinatura.
- map_overview: módulos, entry points e o comando de teste. map_api lê a API real da versão instalada de um pacote em node_modules a partir dos arquivos .d.ts.

**Sempre atualizado e local.** Há um mapa por pasta (um projeto ou uma worktree), compartilhado por todos os agentes que trabalham nela. As mudanças nos arquivos são observadas, os commits disparam uma nova contagem dos arquivos que mudam juntos, e um arquivo sobre o qual um agente pergunta é verificado de novo antes da resposta. O mapa é montado no seu computador e não gasta tokens; cada agente só pode ler o mapa da própria pasta.

**Grafo e impacto.** A aba “Project map” na página Details de um projeto desenha os arquivos como um grafo colorido por módulo: imports em cinza, arquivos que mudam juntos como linhas laranja tracejadas. Digite uma tarefa e clique em “Show” para ver os arquivos que um agente olharia, com os motivos. O card “Project map impact” na aba AI ROI compara as conversas que usaram o mapa com as que não usaram, por sucesso, aprovação de primeira, tokens por tarefa e follow-ups.

**Como ativar:**

1. Confira se a chave “Project map” em Settings → Token savings está ativada; ela vem ativada por padrão.
2. Abra o projeto ou inicie um agente: o mapa é montado uma vez e depois acompanha as mudanças.
3. Veja o grafo em Details → Project map e digite uma tarefa para ver quais arquivos um agente olharia.
4. Para deixá-lo de fora de um agente, desmarque a caixa “Project map” na janela de edição desse agente.

- **Quais agentes usam o mapa?** Todo agente CLI que aceita servidores MCP: Claude Code, Codex, opencode, Copilot, Gemini, Cursor e os demais. Ele não é adicionado a agentes em hosts remotos (SSH).
- **O mapa envia meu código para algum lugar?** Não. O mapa é montado no seu computador e guardado compactado na pasta de dados do app. O que um agente lê de uma resposta da ferramenta vai para o provedor do modelo dele, como qualquer outra coisa que ele lê.
- **Quais linguagens têm símbolos?** TypeScript, TSX, JavaScript, Python e Go. Arquivos de outras linguagens entram no mapa pelo caminho e com as ligações de mudança conjunta.
- **E se o mapa ainda não estiver pronto?** As respostas dizem em que ponto o mapa está. O agente espera no máximo alguns segundos e depois é orientado a seguir com as ferramentas normais.
- **Qual a diferença para o mapa de código?** A janela do mapa de código mostra para você as dependências entre módulos e os arquivos que os agentes mais mexem. O mapa do projeto é um índice vivo que os próprios agentes consultam.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/