Explorar una base de código con Vibe
En esta página
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
asko 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.
Navegación por el código
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 puede | El agente no puede |
|---|---|
| Leer archivos | Escribir o modificar archivos |
| Buscar código | Ejecutar comandos de shell |
| Analizar la estructura del proyecto | Crear 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