---
title: Trabajo con bases de código grandes
description: 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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
  </Step>

  <Step title="Refina tu búsqueda">
    ```
    Show me all files that import the authentication module
    ```

    Explorer puede realizar búsquedas de seguimiento para acotar los resultados.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  **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
</Tip>

***

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Confirma tu progreso">
    ```bash
    git add .
    git commit -m "feat: add notification data models"
    ```

    Confirmar los cambios crea un punto de reversión seguro.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  **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
</Tip>

***

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Aprueba la ejecución">
    Cuando estés conforme con el plan, aprueba la ejecución. Verdent realiza los cambios de manera metódica.
  </Step>
</Steps>

<Tip>
  **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
</Tip>

***

## 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.

<Steps>
  <Step title="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.
  </Step>

  <Step title="Revisa el alcance en Plan Mode">
    ```
    In Plan Mode: Rename calculateTotal to computeFinalTotal across all files
    ```

    Observa el alcance completo antes de hacer cambios.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Ejecuta las pruebas para verificar">
    ```
    Run the full test suite to verify all references were updated correctly
    ```

    Las pruebas detectan cualquier referencia omitida.
  </Step>
</Steps>

<Tip>
  **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
</Tip>

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

***

## Preguntas frecuentes

<Accordion title="¿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.
</Accordion>

<Accordion title="¿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.
</Accordion>

<Accordion title="¿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».
</Accordion>

<Accordion title="¿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.
</Accordion>

***

## Consulta también

<CardGroup cols={2}>
  <Card title="Ejemplos de tareas de varios pasos" icon="list-check" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    Flujos de trabajo complejos de varios pasos y gestión de tareas
  </Card>

  <Card title="Prácticas recomendadas" icon="star" href="/docs/verdent-for-vscode/best-practices/context">
    Estrategias de gestión y optimización del contexto
  </Card>
</CardGroup>