Explorar uma base de código com o Vibe
Nesta página
Lição atualizada em 2 de novembro de 2026: O modo Plan integrado deixou de existir no Vibe Code; a exploração em modo de leitura ocorre agora através do agente
askou de um agente personalizado. Fonte: Agents.
Análise Automática do Projeto
Assim que inicia o Vibe num diretório, o agente analisa automaticamente o seu projeto. Este trabalho ocorre antes mesmo de escrever a sua primeira mensagem. O agente mapeia a árvore de ficheiros — estrutura de pastas, ficheiros chave e ficheiros de configuração — e verifica depois o estado do Git, incluindo a ramificação ativa, ficheiros modificados, ficheiros não rastreados e o último commit. Em seguida, identifica o tipo de projeto com base nos ficheiros de configuração presentes (package.json, pyproject.toml, Cargo.toml, etc.) e lê esses manifestos para identificar as dependências declaradas.
Este contexto é injetado na conversa imediatamente após a abertura. O resultado prático é claro: abra o Vibe num repositório que nunca viu, pergunte “Qual é a arquitetura deste projeto?” e o agente responde instantaneamente, pois não precisa de obter qualquer informação — a árvore de ficheiros e os manifestos já estão à sua frente.
Navegar no Código
Num projeto desconhecido, a primeira questão é quase sempre sobre a estrutura global. Pergunte simplesmente:
Give me an overview of this project. What are the main files and how are they organized?
O Vibe percorre os diretórios, abre ficheiros chave — README, configuração, pontos de entrada — e fornece-lhe um resumo. A partir daí, pode pesquisar com precisão. Para encontrar uma função, variável ou padrão no código, o agente recorre ao grep e ao ripgrep em segundo plano; escolhe automaticamente a ferramenta mais eficiente, preferindo o ripgrep em projetos grandes pela velocidade. Faça perguntas em linguagem natural:
Where is the handleAuthentication function defined?
Find all files that import the database module
Which endpoints use the rateLimiter middleware?
Quando já sabe qual o ficheiro que lhe interessa, direcione a atenção do agente utilizando o prefixo @, suportado por preenchimento automático:
Explain the code in @src/api/routes/auth.ts
Nada o limita a uma única referência por mensagem, tornando as comparações diretas muito naturais:
Compare @src/old/handler.py and @src/new/handler.py, what are the differences?
Contexto Git, Leitura em Tempo Real
Como o Vibe acompanha o estado do repositório durante a sessão, pode questioná-lo sobre o seu trabalho atual em vez de sobre código estático. Pergunte quais os ficheiros alterados desde o último commit, peça para resumir as alterações na ramificação feature/auth em comparação com a main, ou identifique ficheiros não rastreados que deveriam ir para o .gitignore. Em cada caso, o agente executa ele próprio os comandos necessários — git status, git diff, git log — e apresenta os resultados num formato legível, poupando-o de descodificar saídas brutas.
A mesma lógica aplica-se às dependências. Uma pergunta como “Quais são as principais dependências deste projeto? Alguma está obsoleta?” leva o agente a ler o package.json, o pyproject.toml ou o equivalente para o seu ecossistema. E se um servidor de obtenção MCP estiver configurado, pode até verificar as versões realmente disponíveis para responder a “Este projeto está a usar uma versão recente do React?”.
Aprofundar Através da Conversa
O verdadeiro valor do Vibe para exploração reside na natureza conversacional da troca: cada resposta abre a porta à próxima pergunta, mais precisa.
> Explain the structure of the src/services/ folder
< The folder contains 5 services: auth, email, payment, storage, and notification...
> Detail the payment service, how does it handle webhooks?
< The payment service uses Stripe with a webhook handler in payment/webhooks.ts...
> Show me the webhook handler code
< [Displays file content]
Esta abordagem iterativa é frequentemente mais rápida do que a pesquisa manual num editor, precisamente no cenário em que está menos equipado: quando ainda não conhece a base de código e, portanto, não sabe o que procurar.
Explorar com Segurança com o Agente ask ou um Agente de Leitura
Auditar código de terceiros ou investigar um projeto sensível levanta uma questão legítima: e se o agente modificar algo? O Vibe já não possui um modo Plan integrado. Existem duas soluções: o agente ask, selecionado com Shift+Tab ou vibe --agent ask, que lhe pede confirmação antes de usar qualquer ferramenta; ou, melhor ainda, um agente personalizado de apenas leitura (disabled_tools = ["edit", "write_file"], bash definido como ask), descrito no curso Advanced Mistral Vibe. Este último comporta-se da seguinte forma:
| O agente pode | O agente não pode |
|---|---|
| Ler ficheiros | Escrever ou modificar ficheiros |
| Pesquisar código | Executar comandos de shell |
| Analisar a estrutura do projeto | Criar novos ficheiros |
Crie o hábito de mudar para um agente de apenas leitura antes de rever qualquer código que não tenha escrito: mantém todo o conforto de exploração descrito acima, com zero risco de efeitos secundários.
Pontos-chave
- O Vibe analisa automaticamente a árvore de ficheiros, o estado do Git e as dependências no arranque
- O prefixo @ permite referenciar ficheiros específicos com preenchimento automático
- As pesquisas de código utilizam grep/ripgrep em segundo plano
- A exploração conversacional permite aprofundar progressivamente o código
- Um agente de apenas leitura (ou o agente
ask) garante uma exploração sem efeitos secundários