Verdent Docs
Flujos de trabajo habituales

Trabajo con bases de código grandes

Estrategias para navegar y trabajar con bases de código grandes

Trabajar con bases de código grandes requiere estrategias específicas para gestionar las limitaciones de contexto y mantener la productividad. Esta guía ofrece flujos de trabajo prácticos para navegar, comprender y modificar proyectos grandes de manera eficiente con Verdent for VS Code.


Uso del agente Explorer para descubrir la base de código

Supongamos que eres nuevo en una base de código grande y necesitas encontrar dónde está implementada una funcionalidad específica.

Haz preguntas de descubrimiento amplias

Where is user authentication handled in this codebase?

Verdent delega automáticamente en el agente Explorer, un especialista eficiente en tokens para búsquedas en la base de código.

Explorer busca de manera eficiente

El agente Explorer:

  • Busca nombres de archivos y rutas
  • Aplica grep al contenido del código en busca de palabras clave
  • Analiza patrones arquitectónicos
  • Devuelve resultados con rutas de archivos y fragmentos de código

Refina tu búsqueda

Show me all files that import the authentication module

Explorer puede realizar búsquedas de seguimiento para acotar los resultados.

Paraleliza las búsquedas complejas

Para un descubrimiento completo, Verdent puede ejecutar varios agentes Explorer en paralelo:

  • Explorer 1: encontrar la lógica de autenticación
  • Explorer 2: encontrar la lógica de autorización
  • Explorer 3: encontrar la gestión de sesiones

Los resultados llegan más rápido gracias a la búsqueda en paralelo.

Consejos:

  • El agente Explorer trabaja de manera eficiente en bases de código grandes sin llenar el contexto principal
  • Varios agentes Explorer pueden buscar distintos aspectos de forma simultánea
  • Usa Explorer para coincidencia de patrones y descubrimiento arquitectónico
  • Los resultados incluyen rutas de archivos y fragmentos de código relevantes para dar contexto

Dividir las tareas en partes manejables

Supongamos que trabajas en una base de código grande y necesitas agregar una funcionalidad que afecta a muchos archivos.

Identifica los límites naturales de la tarea

En lugar de pedir todo a la vez:

Phase 1: Add the data models for the notification system

Concéntrate primero en un componente autónomo.

Completa la fase por completo

Trabaja la fase 1 en su totalidad, incluidas las pruebas, antes de pasar a la fase 2. Esto crea un punto de control limpio.

Confirma tu progreso

git add .
git commit -m "feat: add notification data models"

Confirmar los cambios crea un punto de reversión seguro.

Limpia el contexto para la siguiente fase

Para tareas complejas, limpia el contexto antes de pasar a la siguiente fase. Esto garantiza que Verdent tenga suficiente capacidad de contexto para mantener un rendimiento óptimo.

Phase 2: Build the notification API endpoints using the data models

Inicia una nueva sesión con un contexto limpio enfocado únicamente en la fase 2.

Consejos:

  • Los puntos de corte naturales evitan el agotamiento del contexto
  • Cada fase debe poder probarse de forma independiente
  • Confirmar los cambios entre fases permite experimentar de forma segura
  • Las sesiones nuevas mantienen el contexto limpio y enfocado

Aprovechar Plan Mode para cambios a gran escala

Supongamos que necesitas refactorizar una funcionalidad distribuida en docenas de archivos en una base de código grande.

Comienza en Plan Mode

Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all files

Plan Mode permite el análisis de solo lectura sin consumir contexto en modificaciones de archivos.

Usa Explorer para encontrar todos los archivos afectados

Use the Explorer agent to find all files that reference payment processing

Garantiza que descubras cada ubicación que necesita actualizarse.

Revisa el plan completo

Verdent presenta un plan que muestra:

  • Todos los archivos que requieren cambios (25 archivos identificados)
  • El conjunto mínimo de archivos que se incluirán en el contexto principal
  • El orden de las operaciones
  • Las dependencias entre los cambios

Revísalo antes de comprometerte con el enfoque.

Aprueba la ejecución

Cuando estés conforme con el plan, aprueba la ejecución. Verdent realiza los cambios de manera metódica.

Consejos:

  • Plan Mode ayuda a identificar conjuntos mínimos de archivos antes de la ejecución
  • Explorer garantiza que no se omita ningún archivo en una refactorización a gran escala
  • Los planes muestran el alcance con claridad antes de consumir contexto
  • Guarda los planes en archivos para documentación y revisión del equipo

Realizar cambios coordinados en muchos archivos

Supongamos que necesitas renombrar una función que se usa en más de 50 archivos de una base de código grande.

Usa Explorer para encontrar todos los usos

Use the Explorer agent to find all files that use the calculateTotal function

Identifica cada archivo que requiere actualización.

Revisa el alcance en Plan Mode

In Plan Mode: Rename calculateTotal to computeFinalTotal across all files

Observa el alcance completo antes de hacer cambios.

Verifica que no se omita ningún archivo

Verdent muestra los 52 archivos que requieren actualización. Revisa la lista para asegurar que esté completa.

Ejecuta los cambios coordinados

Aprueba el plan. Verdent actualiza todos los archivos de forma sistemática, garantizando un cambio de nombre coherente en todas partes.

Ejecuta las pruebas para verificar

Run the full test suite to verify all references were updated correctly

Las pruebas detectan cualquier referencia omitida.

Consejos:

  • Explorer garantiza que no se omita ningún archivo en cambios a gran escala
  • Plan Mode muestra el alcance completo antes de la ejecución
  • Las actualizaciones sistemáticas mantienen la coherencia en todos los archivos
  • Prueba a fondo después de una refactorización a gran escala

Los cambios coordinados en muchos archivos son más seguros por fases: actualiza una capa, verifica y luego continúa con las capas dependientes.


Preguntas frecuentes

¿Cómo sé cuándo me estoy acercando a los límites de contexto?

Las señales incluyen tiempos de respuesta más lentos, sesiones que se prolongan durante varias horas o muchos archivos grandes cargados. Supervisa la duración de tu sesión y la cantidad de archivos. Cuando notes una degradación del rendimiento, completa tu tarea actual, confirma tu progreso e inicia una nueva sesión con un contexto limpio.

¿Es seguro dejar que Verdent modifique docenas de archivos a la vez?

Sí, cuando se usa correctamente. Usa siempre Plan Mode para revisar primero el alcance completo, asegúrate de tener una cobertura de pruebas exhaustiva y confirma los cambios con frecuencia entre fases. Esto te permite verificar los cambios de forma incremental y revertirlos fácilmente si es necesario.

¿Cuándo debo usar el agente Explorer en lugar de cargar archivos directamente?

Usa el agente Explorer para tareas de descubrimiento y búsqueda sin consumir el contexto principal. Carga archivos directamente con menciones @ solo cuando necesites modificarlos. Explorer es ideal para preguntas del tipo «encuentra todos los archivos que...», mientras que las menciones @ son para tareas del tipo «actualiza este archivo específico».

¿Qué preajuste de modelo es mejor para trabajar con bases de código grandes?

Usa el preajuste Performance para operaciones complejas con varios archivos y refactorizaciones. Usa el preajuste Efficiency para búsquedas sencillas y tareas de descubrimiento. Performance ofrece mayor capacidad de razonamiento para cambios coordinados, mientras que Efficiency es más rápido y rentable para la exploración.


Consulta también