---
title: Flujos de trabajo con planificación primero
description: Uso de la planificación asistida por IA para tareas complejas
---

Los flujos de trabajo con planificación primero aprovechan **Plan Mode**, un modo de ejecución de solo lectura en el que Verdent analiza código, realiza investigaciones y crea planes detallados antes de ejecutar cualquier cambio. Este flujo de trabajo separa la planificación estratégica de la implementación, lo que permite revisar y refinar antes de comprometerse con modificaciones de código.

### Cuándo usar Plan Mode

- Cambios complejos en varios archivos que requieren coordinación
- Incertidumbre sobre el mejor enfoque de implementación
- Cambios de alto riesgo en código crítico para producción
- Tareas en bases de código desconocidas donde se necesita exploración
- Necesidades de planificación estratégica que requieren aprobación antes de la ejecución

---

## Desglose de tareas asistido por IA

Verdent descompone automáticamente las solicitudes complejas en pasos secuenciales y manejables mediante el desglose de tareas asistido por IA.

### Proceso de desglose

<Steps>
  <Step title="Análisis de la solicitud">
    Verdent analiza tu solicitud en lenguaje natural para identificar:
    - El objetivo principal y el resultado deseado
    - Archivos, componentes o sistemas afectados
    - Operaciones técnicas y dependencias necesarias
    - Posibles factores de complejidad
  </Step>
  <Step title="Contexto de la base de código">
    Verdent examina la estructura de tu proyecto para comprender:
    - La arquitectura existente y los patrones establecidos
    - La organización de archivos y la pila tecnológica
    - Las implementaciones actuales que requieren modificación
  </Step>
  <Step title="Descomposición de tareas">
    Verdent divide la solicitud en subtareas lógicas:
    - Identifica puntos de corte naturales y fases de implementación
    - Ordena las tareas por dependencia (primero las tareas prerequisito)
    - Agrupa operaciones relacionadas
    - Estima el alcance y la complejidad de cada subtarea
  </Step>
  <Step title="Aclaración interactiva">
    Verdent puede hacer preguntas para refinar el desglose:
    - "¿Debo modificar la validación existente o crear un nuevo validador?"
    - "¿Quieres actualizar las pruebas de todos los componentes afectados?"
    - "¿Este cambio debe aplicarse tanto a los componentes web como a los móviles?"
  </Step>
</Steps>

### Características del desglose

<Tabs>
  <Tab title="Granularidad">
    - Tareas dimensionadas para 15-45 minutos de trabajo concentrado
    - Puntos de corte naturales para pruebas y validación
    - Lo suficientemente complejas para ser significativas, lo suficientemente simples para ejecutarse
  </Tab>
  <Tab title="Secuenciación">
    - Se respetan las dependencias (configuración antes de la implementación)
    - Progresión lógica (capa de datos → lógica de negocio → interfaz de usuario)
    - Pasos de verificación después de las fases principales
  </Tab>
  <Tab title="Personalización">
    El formato del desglose del plan se puede personalizar mediante `plan_rules.md` para controlar:
    - El nivel de detalle (general frente a granular)
    - La estructura y las secciones del plan
    - La información incluida (estimaciones de tiempo, riesgos, dependencias)
  </Tab>
</Tabs>

---

## Revisión y aprobación del plan

Después de enviar una solicitud en Plan Mode, Verdent genera un plan estructurado que se muestra en la vista de chat para tu revisión.

### Proceso de revisión

<Steps>
  <Step title="Recibe un plan estructurado">
    Verdent genera un plan con secciones claras, pasos numerados, archivos afectados y dependencias identificadas
  </Step>
  <Step title="Analiza la calidad del plan">
    Revisa lo siguiente:
    - **Corrección:** ¿El enfoque resuelve el problema?
    - **Completitud:** ¿Se incluyen todos los pasos necesarios?
    - **Eficiencia:** ¿Es este el mejor enfoque?
    - **Riesgo:** ¿Qué podría salir mal? ¿Casos límite o problemas de seguridad?
  </Step>
  <Step title="Haz preguntas aclaratorias">
    Solicita información adicional si algo no está claro:
    ```
    Can you explain step 3 in more detail?
    Why are we modifying both the service and controller?
    What happens if the API call fails in step 5?
    ```
  </Step>
  <Step title="Solicita modificaciones">
    Proporciona comentarios para revisar el plan:
    ```
    Let's use JWT tokens instead of OAuth2
    Can we break step 4 into smaller substeps?
    Add error handling considerations to the plan
    ```
  </Step>
  <Step title="Elige tu próxima acción">
    Después de que Verdent genera el plan, se presentan dos opciones:
    - **Edit**: Solicita modificaciones, haz preguntas aclaratorias o refina el plan aún más
    - **Start Building**: Cambia a Agent Mode y comienza a ejecutar el plan aprobado
  </Step>
</Steps>

### Opciones de interacción con el plan

Después de revisar el plan generado, Verdent presenta dos opciones:

**Edit:**

Elige esta opción para:
- Solicitar cambios específicos en el enfoque del plan
- Hacer preguntas aclaratorias sobre los detalles de implementación
- Agregar elementos o consideraciones que falten
- Simplificar o ampliar ciertos pasos
- Explorar enfoques alternativos

Esto te mantiene en Plan Mode para un refinamiento iterativo sin ejecutar ningún cambio.

**Start Building:**

Elige esta opción para:
- Cambiar a Agent Mode y comenzar la ejecución
- Implementar el plan aprobado con total autonomía
- Realizar modificaciones de archivos y ejecutar comandos según lo planificado

También puedes optar por:
- **Implementación manual**: Revisa el plan e implementa los cambios por tu cuenta
- **Ejecución incremental**: Pide a Verdent que implemente fases específicas con puntos de control para revisar entre etapas

<Tip>
Usa **Edit** para iterar sobre el plan tantas veces como sea necesario. Elige **Start Building** solo cuando estés seguro de que el enfoque es correcto y completo.
</Tip>

---

## Planificación iterativa

Puedes modificar e iterar libremente sobre los planes seleccionando **Edit** y proporcionando comentarios de manera conversacional. Verdent trata la generación de planes como un proceso interactivo e iterativo.

### Métodos de modificación

**Solicitar cambios específicos:**
```
Change step 3 to use Redux instead of Context API
Add input validation before the database insert
Swap the order of steps 4 and 5
```

**Agregar elementos que faltan:**
```
Add error handling for network failures
Include rollback procedures
Add performance optimization considerations
```

**Simplificar o ampliar:**
```
This is too complex - can we simplify the approach?
Break down step 5 into more detailed substeps
Give me more detail on the database schema changes
```

**Explorar alternativas:**
```
What if we used webhooks instead?
Show me an alternative plan using microservices architecture
Can we accomplish this without changing the database schema?
```

### Ejemplo de flujo de iteración

```
User: "Add user authentication to the API"

[Verdent generates initial plan with JWT tokens]

User: "Actually, let's use OAuth2 instead of JWT"

[Verdent revises plan to use OAuth2]

User: "Add step for migrating existing users"

[Verdent adds migration step to plan]

User: "Can you break down the migration step more?"

[Verdent expands migration with detailed substeps]

User: Chooses **Start Building**

[Verdent switches to Agent Mode and begins execution]
```

**Iteraciones ilimitadas:**
- No hay límite en el número de revisiones
- Cada iteración mantiene el contexto de la conversación
- Las versiones anteriores se conservan en el historial del chat
- Puedes hacer referencia a versiones anteriores del plan: "vuelve al primer enfoque"

<Note>
El rechazo de un plan es una parte natural del proceso de planificación iterativa. Garantiza que solo se ejecuten estrategias aprobadas y bien comprendidas, lo que reduce el esfuerzo desperdiciado en implementaciones incorrectas.
</Note>

---

## Preguntas frecuentes (FAQ)

<Accordion title="¿Plan Mode realmente escribe algún código en mis archivos?">
**No.** Plan Mode es estrictamente de solo lectura:

- Verdent puede leer archivos, buscar código y analizar tu base de código
- **No se realizan escrituras, ediciones ni eliminaciones de archivos** durante Plan Mode
- Los planes se muestran únicamente en la vista de chat
- La ejecución de código comienza solo después de que apruebes explícitamente y cambies a Agent Mode

**Garantía de seguridad:** Plan Mode no puede modificar tu código accidentalmente. Está diseñado para una exploración segura y el desarrollo de estrategias.
</Accordion>

<Accordion title="¿Puedo ejecutar un plan de forma incremental en lugar de todo a la vez?">
**Sí.** La ejecución incremental es totalmente compatible:

**Patrón de aprobación incremental:**
```
Let's start with Phase 1 first, then we'll review before continuing
Implement steps 1-3, then stop for review
Do the database migration first, I'll review before the API changes
```

**Cómo funciona:**
1. Verdent ejecuta los pasos especificados
2. Se detiene en un punto de control para revisión
3. Revisas los resultados y proporcionas comentarios
4. Continúas con la siguiente fase o ajustas el enfoque
5. Repites hasta completar

**Ideal para:** Cambios de alto riesgo, patrones desconocidos, código crítico para producción donde un despliegue por fases reduce el riesgo.

<Tip>
La ejecución incremental te permite aprobar partes de un plan mientras aplazas otras, lo cual es útil cuando las prioridades cambian a mitad de la tarea.
</Tip>
</Accordion>

<Accordion title="¿Qué sucede si rechazo un plan?">
**El rechazo de un plan es completamente normal y esperado:**

- Verdent genera un nuevo plan según tus comentarios
- Las versiones anteriores del plan permanecen en el historial del chat como referencia
- No se producen cambios en el código (Plan Mode es de solo lectura)
- Puedes iterar de forma ilimitada hasta quedar satisfecho

**Razones comunes de rechazo:**
- El enfoque es demasiado complejo o demasiado simple
- Faltan casos límite o manejo de errores
- Existe una mejor arquitectura alternativa
- Requisitos malinterpretados

**Consejo profesional:** El rechazo forma parte del proceso. Es mejor refinar los planes de forma iterativa que desperdiciar esfuerzo ejecutando estrategias incorrectas.
</Accordion>

<Accordion title="¿Cómo cambio entre Plan Mode y Agent Mode?">
**El cambio es instantáneo mediante el cuadro de entrada:**

**Para entrar en Plan Mode:**
- Selecciona el botón **Switch Mode** en el cuadro de entrada
- Elige **Plan Mode** en el menú desplegable
- O di: "Switch to Plan Mode"

**Para salir de Plan Mode:**
- Selecciona el botón **Switch Mode** en el cuadro de entrada
- Elige **Agent Mode** en el menú desplegable
- O elige **Start Building** después de revisar un plan

**Persistencia del modo:**
- La elección del modo persiste dentro de la sesión actual
- Las nuevas sesiones comienzan en el Agent Mode predeterminado
- Puedes cambiar de modo libremente en cualquier momento

**Flujo de trabajo típico:** Plan Mode → revisar → Agent Mode → ejecutar → volver a Plan Mode para la siguiente función compleja.
</Accordion>

<Accordion title="¿Puedo personalizar el formato y el nivel de detalle de los planes generados?">
**Sí, usando `plan_rules.md`:**

**Ubicación:** `~/.verdent/plan_rules.md` (directorio de configuración global)

**Lo que puedes personalizar:**
- **Nivel de detalle:** Resumen general frente a paso a paso granular
- **Estructura del plan:** Secciones a incluir (resumen, riesgos, dependencias, pruebas)
- **Información incluida:** Estimaciones de tiempo, rutas de archivos, pasos de verificación
- **Preferencias de formato:** Listas numeradas, fases, categorización

**Ejemplo de plan_rules.md:**
```markdown
# Plan Rules

## Plan Structure
- Start with a brief summary (2-3 sentences)
- Include estimated time for each major step
- List prerequisites before implementation steps
- Identify potential risks and mitigation strategies

## Level of Detail
- Break tasks into subtasks of 15-30 minutes
- Include specific file paths for modifications
- List functions or components to create/modify
- Provide verification steps for each phase
```

**Los cambios se aplican de inmediato** a las nuevas sesiones de Plan Mode.
</Accordion>

<Accordion title="¿Plan Mode usa el mismo contexto que Agent Mode?">
**No, Plan Mode tiene una gestión de contexto separada:**

- **Contexto de Plan Mode:** Optimizado para el análisis y el pensamiento estratégico
- **Contexto de Agent Mode:** Optimizado para la ejecución y la implementación
- **Beneficio:** Los planes no contaminan el contexto de ejecución con investigación exploratoria

**Por qué importa la separación:**
- Plan Mode puede explorar varios enfoques sin saturar Agent Mode
- Los intentos de plan rechazados no consumen el contexto de Agent Mode
- Comienzas desde cero al cambiar a la ejecución

**Reinicio del contexto:** Cambiar de modo proporciona un contexto nuevo para el nuevo tipo de tarea.
</Accordion>

<Accordion title="¿Qué pasa si Verdent hace preguntas aclaratorias durante la planificación?">
**Las preguntas aclaratorias forman parte del proceso de desglose:**

**Por qué se hacen preguntas:**
- Los requisitos ambiguos necesitan aclaración
- Existen varios enfoques válidos (elige uno)
- Casos límite o restricciones aún no especificados
- Preferencias no claras a partir de la solicitud inicial

**Cómo responder:**
- Responde directamente en lenguaje conversacional
- Proporciona ejemplos si es útil
- Di "tú decides" si confías en el criterio de Verdent
- Haz preguntas a tu vez si no estás seguro

**Ejemplo de intercambio:**
```
Verdent: "Should I modify the existing validation or create a new validator?"
You: "Create a new validator - we'll deprecate the old one later"
Verdent: [Updates plan with new validator approach]
```

**Consejo profesional:** Las preguntas ayudan a Verdent a generar planes precisos y relevantes adaptados a tus necesidades específicas.
</Accordion>

---

## Consulta también

<CardGroup cols={2}>
  <Card title="Modos de ejecución" icon="sliders" href="/docs/verdent-for-vscode/execution-modes/overview">
    Aprende más sobre Plan Mode y otros modos de ejecución
  </Card>
  <Card title="Buenas prácticas: prompts" icon="message" href="/docs/verdent-for-vscode/best-practices/prompts">
    Escribe prompts eficaces para Plan Mode
  </Card>
</CardGroup>