Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Explorar uma base de código com o Vibe

Aula 9 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Análise Automática do Projeto
  2. Navegar no Código
  3. Contexto Git, Leitura em Tempo Real
  4. Aprofundar Através da Conversa
  5. Explorar com Segurança com o Agente ask ou um Agente de Leitura
  6. Pontos-chave

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 ask ou 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.

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 podeO agente não pode
Ler ficheirosEscrever ou modificar ficheiros
Pesquisar códigoExecutar comandos de shell
Analisar a estrutura do projetoCriar 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