Verdent Docs
Flujos de trabajo habituales

Ejemplos de tareas de varios pasos

Gestión de tareas complejas de varios pasos con Verdent

Verdent for VS Code sobresale en la descomposición autónoma de tareas complejas de varios pasos. Esta guía ofrece flujos de trabajo paso a paso para escenarios comunes de varios pasos, mostrando exactamente cómo Verdent gestiona la descomposición de tareas, la gestión de dependencias y la ejecución progresiva.


Uso de Plan Mode para implementaciones complejas

Supongamos que quieres revisar un plan detallado antes de que Verdent haga cualquier cambio en tu código.

Cambia a Plan Mode

Selecciona el botón "Switch Mode" en la interfaz y elige "Plan Mode".

Plan Mode es de solo lectura: Verdent puede analizar código, realizar investigaciones y crear planes sin modificar archivos ni ejecutar comandos.

Envía tu solicitud compleja

Refactor this codebase to replace our custom authentication with OAuth 2.0

Verdent analiza tu implementación actual a fondo.

Responde las preguntas aclaratorias

Verdent puede hacer preguntas para eliminar la incertidumbre:

  • ¿Qué proveedor de OAuth debemos usar?
  • ¿Los tokens deben almacenarse en localStorage o en cookies?
  • ¿Necesitamos admitir múltiples proveedores de OAuth?

Responde estas preguntas para refinar el plan.

Revisa el plan detallado

Verdent presenta un plan completo que muestra:

  • Archivos que se crearán
  • Archivos existentes que se modificarán
  • Pasos de implementación en orden lógico
  • Dependencias entre pasos

Revisa este plan con atención antes de continuar.

Elige tu próxima acción

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

  • Elige Edit para solicitar modificaciones o hacer preguntas aclaratorias
  • Elige Start Building para cambiar a Agent Mode y comenzar la ejecución

Puedes iterar sobre el plan tantas veces como necesites antes de construir.

Consejos:

  • Usa Plan Mode para funciones que afectan a varios archivos
  • Realiza varias rondas de revisión del plan para refinar el enfoque
  • Guarda el plan en un archivo para que el equipo lo analice antes de ejecutar
  • Plan Mode ayuda a garantizar la alineación entre tus expectativas y la solución propuesta por Verdent
  • Personaliza el formato del plan: Accede a Settings → Rules → Plan Rules para controlar la estructura del plan, el nivel de detalle y las preferencias de formato

Descomposición de solicitudes de funciones grandes

Supongamos que estás construyendo un sistema de pago de comercio electrónico complejo con varios componentes integrados.

Proporciona el objetivo de alto nivel

Build a complete checkout system with cart management, payment processing, order confirmation, and inventory updates

Verdent analiza lo que se debe hacer.

Verdent crea subtareas lógicas

El sistema descompone esto de forma autónoma en:

  1. Crear el modelo de datos del carrito de compras y API
  2. Construir la interfaz del carrito con agregar/quitar/actualizar artículos
  3. Implementar la página de pago con el formulario de dirección de envío
  4. Integrar la pasarela de pago (Stripe o el proveedor configurado)
  5. Crear la página de confirmación del pedido
  6. Agregar la lógica de actualización del inventario
  7. Implementar el sistema de confirmación por correo electrónico
  8. Escribir pruebas de integración

Cada subtarea se muestra en la lista de tareas pendientes con descripciones claras.

Verdent gestiona las dependencias automáticamente

Verdent ejecuta las subtareas en el orden correcto:

  • Crea los modelos de datos antes de los endpoints de API que los usan
  • Construye los endpoints del backend antes de los componentes del frontend que los invocan
  • Implementa las funciones principales antes de agregar pruebas

Las dependencias se gestionan automáticamente sin intervención manual.

Supervisa el progreso en tiempo real

Observa cómo la lista de tareas pendientes se actualiza en tiempo real mientras Verdent avanza por cada subtarea. Los elementos pendientes pasan de pendiente → en progreso → completado.

Consejos:

  • Deja que Verdent gestione la descomposición de forma autónoma en la mayoría de las tareas
  • Usa Plan Mode si quieres revisar la descomposición antes de la ejecución
  • Verdent ajusta su enfoque cuando encuentra casos límite o nuevos requisitos
  • La lista de tareas pendientes visible aporta transparencia a la ejecución de varios pasos

Proyectos de refactorización de varias fases

Supongamos que estás refactorizando una base de código grande y quieres abordarla en fases manejables.

Define el enfoque de varias fases

In Plan Mode: Refactor this codebase to replace our custom authentication with OAuth 2.0. I want this done in phases so we can test incrementally.

Verdent propone la descomposición en fases

Verdent sugiere un plan de varias fases:

  • Fase 1: Agregar la biblioteca de OAuth y configurar los endpoints
  • Fase 2: Actualizar el modelo de usuario y el esquema de la base de datos
  • Fase 3: Migrar la lógica de autenticación existente
  • Fase 4: Eliminar el código de autenticación obsoleto
  • Fase 5: Actualizar las pruebas y la documentación

Cada fase se puede probar de forma independiente.

Ejecuta fase por fase

Aprueba la Fase 1, permite que Verdent la ejecute y luego pruébala:

npm test

Una vez verificado que la Fase 1 funciona, pasa a la Fase 2.

Ajusta las fases siguientes si es necesario

Según lo que aprendas en la Fase 1, puedes ajustar el enfoque de las fases restantes:

For Phase 2, let's also add user role migration to the database schema changes

Completa todas las fases de forma incremental

Avanza por todas las fases con pruebas y verificación entre cada una, lo que garantiza la seguridad y permite corregir el rumbo.

Consejos:

  • La refactorización de varias fases reduce el riesgo al permitir pruebas incrementales
  • Cada fase debe dejar la base de código en un estado funcional
  • Haz un commit después de cada fase para revertir fácilmente si es necesario
  • Ajusta las fases posteriores según lo aprendido en las anteriores

Coordinación de cambios en el backend y el frontend

Supongamos que estás agregando una función que requiere actualizaciones sincronizadas tanto en los API del backend como en los componentes del frontend.

Describe la función full-stack

Add a commenting system where users can add comments to blog posts. Include backend API, database schema, and frontend UI

Verdent coordina un enfoque backend-first

Verdent suele trabajar primero el backend en las funciones full-stack:

  1. Crear la migración de la base de datos para la tabla de comentarios
  2. Agregar el endpoint de API para crear comentarios
  3. Agregar el endpoint de API para recuperar comentarios
  4. Definir las interfaces de TypeScript para los datos de los comentarios
  5. Construir el componente del formulario de comentarios del frontend
  6. Crear el componente de visualización de comentarios
  7. Conectar el frontend con los endpoints de API

Verdent garantiza la coherencia

Verdent garantiza que:

  • Las interfaces de TypeScript del frontend coincidan con las estructuras de datos del backend
  • Las URL de los endpoints de API se referencien correctamente en el código del frontend
  • Los formatos de solicitud/respuesta se alineen entre el backend y el frontend
  • El manejo de errores sea coherente en todo el stack

Pruebas de integración

Write integration tests for the commenting system covering the full stack

Verdent crea pruebas que verifican que el backend y el frontend funcionen correctamente en conjunto.

Consejos:

  • El enfoque backend-first garantiza que el frontend tenga API funcionales con los que integrarse
  • Verdent mantiene la coherencia entre el código del backend y el frontend automáticamente
  • Las interfaces de TypeScript ayudan a detectar problemas de integración en tiempo de compilación
  • Las pruebas de integración verifican que la función completa funcione de extremo a extremo

Uso de subagentes para la ejecución en paralelo

Supongamos que tienes varias tareas independientes que podrían realizarse simultáneamente.

Identifica las tareas paralelizables

Generate unit tests for all service classes in the src/services directory

Estos archivos de prueba son independientes y se pueden crear en paralelo.

Verdent delega en varios subagentes

Verdent usa automáticamente varios subagentes para trabajar en tareas independientes de forma concurrente:

  • Subagente 1: Crea pruebas para UserService
  • Subagente 2: Crea pruebas para PaymentService
  • Subagente 3: Crea pruebas para NotificationService
  • Subagente 4: Crea pruebas para AuthService

Todo el trabajo ocurre en paralelo, lo que ahorra tiempo.

Los resultados se integran

Cada subagente devuelve sus resultados. Verdent integra todos los archivos de prueba en el proyecto con la nomenclatura y la estructura adecuadas.

Verificación secuencial

Tras la creación en paralelo, ejecuta las pruebas de forma secuencial para verificar que todas funcionen:

npm test

Consejos:

  • Verdent paraleliza automáticamente las tareas independientes mediante subagentes
  • El trabajo poco acoplado (archivos de prueba separados, componentes independientes) se beneficia de la paralelización
  • El trabajo muy acoplado (archivos con dependencias) se realiza de forma secuencial para garantizar la corrección
  • La ejecución en paralelo acelera significativamente los cambios a gran escala

Preguntas frecuentes

¿Puedo detener Verdent en medio de una tarea de varios pasos?

Sí. Puedes interrumpir la ejecución en cualquier momento. Verdent completará el paso actual en el que está trabajando y luego se detendrá. El progreso hasta ese punto se conserva. Puedes revisar lo que se ha hecho, hacer ajustes y continuar o adoptar un enfoque diferente.

¿Cómo sé qué está haciendo Verdent en este momento en una tarea larga?

Observa la lista de tareas pendientes. Muestra el estado en tiempo real con un elemento marcado como "en progreso" en cualquier momento. El elemento activo muestra exactamente en qué está trabajando Verdent actualmente. Los elementos completados se marcan como terminados y los pendientes muestran lo que queda por hacer.

¿Qué pasa si no estoy de acuerdo con cómo Verdent descompuso mi tarea?

Usa Plan Mode para revisar y ajustar la descomposición antes de la ejecución. En Plan Mode, puedes dar comentarios como "Divide el trabajo del frontend en componentes separados" o "Combina esos dos pasos". Verdent revisará el plan según tus indicaciones antes de escribir cualquier código.

¿Debo usar Plan Mode para cada tarea de varios pasos?

No necesariamente. Usa Plan Mode para funciones complejas que afectan a muchos archivos, refactorizaciones grandes o cuando quieras revisar el enfoque primero. Para tareas conocidas y sencillas, Verdent puede ejecutarlas directamente con visibilidad de la lista de tareas pendientes en tiempo real. Plan Mode agrega un paso de revisión para los cambios de mayor riesgo.

¿Puedo modificar el plan de Verdent después de que haya comenzado la ejecución?

Puedes dar orientación correctiva mientras Verdent trabaja. Di "En realidad, usa un enfoque diferente para la integración de API" y Verdent ajustará los pasos restantes. Para cambios importantes en el plan, es mejor detenerse, hacer un commit de lo realizado y comenzar una nueva sesión con el enfoque revisado.


Consulta también