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 moduleExplorer 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 systemConcé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 modelsInicia 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 filesPlan 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 processingGarantiza 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 functionIdentifica cada archivo que requiere actualización.
Revisa el alcance en Plan Mode
In Plan Mode: Rename calculateTotal to computeFinalTotal across all filesObserva 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 correctlyLas 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.