Ir al contenido principal
Español— Elegir un idioma
Menú

Explorar una base de código con Vibe

Lección 9 de 16 Actualizado el 2 de noviembre de 2026 Desarrollador
En esta página
  1. Escaneo automático del proyecto
  2. Navegación por el código
  3. Contexto de Git, lectura en tiempo real
  4. Profundizar mediante la conversación
  5. Explorar con seguridad usando el agente ask o un agente de solo lectura
  6. Puntos clave

Lección actualizada el 2 de noviembre de 2026: El modo Plan integrado ya no existe en Vibe Code; la exploración de solo lectura se realiza ahora mediante el agente ask o un agente personalizado. Fuente: Agents.

Escaneo automático del proyecto

En cuanto lanzas Vibe en un directorio, el agente escanea automáticamente tu proyecto. Esta tarea se ejecuta antes incluso de que escribas tu primer mensaje. Mapea el árbol de archivos —estructura de carpetas, archivos clave y archivos de configuración— y comprueba el estado de Git, incluyendo la rama activa, los archivos modificados, los archivos no rastreados y el último commit. A continuación, identifica el tipo de proyecto basándose en los archivos de configuración presentes (package.json, pyproject.toml, Cargo.toml, etc.) y lee estos manifiestos para identificar las dependencias declaradas.

Este contexto se inyecta en la conversación inmediatamente al abrir la herramienta. El resultado práctico es claro: abre Vibe en un repositorio que nunca has visto, pregunta «¿Cuál es la arquitectura de este proyecto?» y el agente responde al instante porque no necesita recuperar nada; el árbol de archivos y los manifiestos ya están frente a él.

En un proyecto desconocido, la primera pregunta suele ser casi siempre sobre la estructura general. Pídeselo simplemente:

Dame una visión general de este proyecto. ¿Cuáles son los archivos principales y cómo están organizados?

Vibe recorre los directorios, abre los archivos clave —README, configuración, puntos de entrada— y te ofrece un resumen. A partir de ahí, puedes buscar con precisión. Para encontrar una función, una variable o un patrón en el código, el agente utiliza grep y ripgrep en segundo plano; él mismo elige la herramienta más eficiente, prefiriendo ripgrep en proyectos grandes por su velocidad. Formula preguntas en lenguaje natural:

¿Dónde está definida la función handleAuthentication?
Encuentra todos los archivos que importan el módulo de base de datos
¿Qué endpoints utilizan el middleware rateLimiter?

Cuando ya sabes qué archivo te interesa, dirige la atención del agente usando el prefijo @, compatible con autocompletado:

Explica el código en @src/api/routes/auth.ts

Nada te limita a una única referencia por mensaje, lo que hace que las comparaciones directas sean muy naturales:

Compara @src/old/handler.py y @src/new/handler.py, ¿cuáles son las diferencias?

Contexto de Git, lectura en tiempo real

Dado que Vibe rastrea el estado del repositorio durante la sesión, puedes consultarle sobre tu trabajo actual en lugar de sobre código estático. Pregunta qué archivos han cambiado desde el último commit, pide que resuma los cambios en la rama feature/auth en comparación con main, o detecta archivos no rastreados que deberían incluirse en .gitignore. En cada caso, el agente ejecuta los comandos necesarios por sí mismo —git status, git diff, git log— y presenta los resultados en un formato legible, para que no tengas que decodificar una salida en bruto.

La misma lógica se aplica a las dependencias. Una pregunta como «¿Cuáles son las dependencias principales de este proyecto? ¿Alguna está obsoleta?» lleva al agente a leer package.json, pyproject.toml o el equivalente para tu ecosistema. Y si hay configurado un servidor de recuperación MCP, incluso puede comprobar las versiones realmente disponibles para responder a «¿Este proyecto está usando una versión reciente de React?».

Profundizar mediante la conversación

El verdadero valor de Vibe para la exploración reside en la naturaleza conversacional del intercambio: cada respuesta abre la puerta a la siguiente pregunta, más precisa.

> Explica la estructura de la carpeta src/services/
< La carpeta contiene 5 servicios: auth, email, payment, storage y notification...

> Detalla el servicio de payment, ¿cómo gestiona los webhooks?
< El servicio de payment usa Stripe con un manejador de webhooks en payment/webhooks.ts...

> Muéstrame el código del manejador de webhooks
< [Muestra el contenido del archivo]

Este enfoque iterativo suele ser más rápido que la búsqueda manual en un editor, precisamente en el escenario donde estás menos equipado: cuando aún no conoces la base de código y, por tanto, no sabes qué buscar.

Explorar con seguridad usando el agente ask o un agente de solo lectura

Auditar código de terceros o investigar un proyecto sensible plantea una pregunta legítima: ¿y si el agente modifica algo? Vibe ya no dispone de un modo Plan integrado. Existen dos soluciones: el agente ask, que se selecciona con Mayús+Tab o vibe --agent ask, y que te pide confirmación antes de usar cualquier herramienta; o, mejor aún, un agente personalizado de solo lectura (disabled_tools = ["edit", "write_file"], bash configurado como ask), descrito en el curso Mistral Vibe avanzado. Este último se comporta de la siguiente manera:

El agente puedeEl agente no puede
Leer archivosEscribir o modificar archivos
Buscar códigoEjecutar comandos de shell
Analizar la estructura del proyectoCrear nuevos archivos

Acostúmbrate a cambiar a un agente de solo lectura antes de revisar cualquier código que no hayas escrito tú mismo: conservas toda la comodidad de exploración descrita anteriormente, con cero riesgo de efectos secundarios.

Puntos clave

  • Vibe escanea automáticamente el árbol de archivos, el estado de Git y las dependencias al iniciarse
  • El prefijo @ permite hacer referencia a archivos específicos con autocompletado
  • Las búsquedas de código utilizan grep/ripgrep en segundo plano
  • La exploración conversacional permite profundizar progresivamente en el código
  • Un agente de solo lectura (o el agente ask) garantiza una exploración sin efectos secundarios