# Flujos de trabajo con planificación primero (/es/docs/verdent-for-vscode/configuration/plan-workflows)
> 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 [#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 [#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 [#proceso-de-desglose]
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
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
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
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?"
### Características del desglose [#características-del-desglose]
* 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
* 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
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)
***
## Revisión y aprobación del plan [#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 [#proceso-de-revisión]
Verdent genera un plan con secciones claras, pasos numerados, archivos afectados y dependencias identificadas
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?
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?
```
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
```
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
### Opciones de interacción con el plan [#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
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.
***
## Planificación iterativa [#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 [#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 [#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"
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.
***
## Preguntas frecuentes (FAQ) [#preguntas-frecuentes-faq]
**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.
**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.
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.
**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.
**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.
**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.
**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.
**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.
***
## Consulta también [#consulta-también]
Aprende más sobre Plan Mode y otros modos de ejecución
Escribe prompts eficaces para Plan Mode