Flujos de trabajo con planificación primero

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

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

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

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

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?"

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

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

Recibe un plan estructurado

Verdent genera un plan con secciones claras, pasos numerados, archivos afectados y dependencias identificadas

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?

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?

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

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

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

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"

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)

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

¿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:

Verdent ejecuta los pasos especificados
Se detiene en un punto de control para revisión
Revisas los resultados y proporcionas comentarios
Continúas con la siguiente fase o ajustas el enfoque
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.

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

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

¿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:

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

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

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