update_todo_list

La herramienta update_todo_list reemplaza toda la lista de TODO con una lista de verificación actualizada que refleja el estado actual. Proporciona seguimiento de tareas paso a paso, permitiendo la confirmación de finalización antes de actualizar y la adición dinámica de nuevos todos descubiertos durante tareas complejas.

Parámetros

La herramienta acepta estos parámetros:

• todos (requerido): Una lista de verificación en markdown con descripciones de tareas e indicadores de estado

Qué Hace

Esta herramienta gestiona una lista de TODO completa que realiza seguimiento del progreso de las tareas a través de diferentes estados. Reemplaza toda la lista con cada actualización, garantizando que el estado actual refleje con precisión todas las tareas pendientes, en progreso y completadas. El sistema muestra la lista de TODO como recordatorios en los mensajes posteriores.

¿Cuándo se usa?

• Cuando las tareas involucran múltiples pasos que requieren seguimiento sistemático
• Cuando se descubren nuevos elementos accionables durante la ejecución de la tarea
• Al actualizar el estado de varios todos simultáneamente
• Cuando los proyectos complejos se benefician de un seguimiento de progreso claro y paso a paso
• Al organizar flujos de trabajo de múltiples fases con dependencias

Características Principales

• Mantiene una lista de verificación en markdown de un solo nivel con tres estados
• Actualiza múltiples estados de tareas en una sola operación
• Agrega dinámicamente nuevos todos a medida que se descubren durante la ejecución
• Proporciona seguimiento visual del progreso a través de indicadores de estado
• Se integra con el sistema de recordatorios para visibilidad persistente de las tareas
• Admite la reordenación de tareas según la prioridad de ejecución
• Preserva todas las tareas no terminadas a menos que se eliminen explícitamente
• Habilita actualizaciones de estado en lote eficientes

Limitaciones

• Limitada a listas de verificación de un solo nivel (sin anidamiento ni subtareas)
• No puede eliminar tareas a menos que estén completadas o ya no sean relevantes
• Requiere reemplazo completo de la lista en lugar de actualizaciones incrementales
• Los cambios de estado deben gestionarse explícitamente a través de llamadas a la herramienta
• Sin seguimiento integrado de dependencias de tareas
• No puede programar tareas para ejecución futura
• Limitada a tres estados (pendiente, en progreso, completada)

Indicadores de Estado

La herramienta usa tres indicadores de estado distintos:

• [ ] Pendiente: Tarea aún no iniciada
• [-] En Progreso: Tarea actualmente en trabajo
• [x] Completada: Tarea completamente terminada sin problemas sin resolver

Cómo Funciona

Cuando se invoca la herramienta update_todo_list, sigue este proceso:

1. Validación de Estado:

   • Analiza el formato de lista de verificación en markdown
   • Valida que los indicadores de estado estén correctamente formateados
   • Garantiza que las descripciones de las tareas sean claras y accionables

2. Reemplazo de Lista:

   • Reemplaza completamente la lista de TODO existente
   • Preserva el orden de las tareas según se especifica en la actualización
   • Mantiene las descripciones de las tareas y los estados

3. Integración con Recordatorios:

   • Integra la lista actualizada con el sistema de recordatorios
   • Muestra las tareas actuales en los encabezados de mensajes posteriores
   • Proporciona visibilidad persistente del progreso de las tareas

4. Seguimiento de Progreso:

   • Realiza seguimiento del estado de finalización entre múltiples actualizaciones
   • Mantiene el historial de tareas para referencia
   • Admite la continuación del flujo de trabajo entre sesiones

Mejores Prácticas

Directrices de Gestión de Tareas

• Marca las tareas como completadas inmediatamente después de que todo el trabajo esté terminado
• Comienza la siguiente tarea marcándola como en progreso
• Agrega nuevos todos tan pronto como se identifiquen durante la ejecución
• Usa nombres de tareas claros y descriptivos que indiquen acciones específicas
• Ordena las tareas por secuencia de ejecución lógica o prioridad

Patrones de Actualización de Estado

• Actualiza múltiples estados simultáneamente al hacer la transición entre tareas
• Confirma la finalización de la tarea antes de marcarla como terminada
• Mantén las tareas en progreso enfocadas en el trabajo actual
• Agrega tareas bloqueantes cuando se descubren dependencias

Cuándo Usar

Usa esta herramienta cuando:

• La tarea involucra múltiples pasos o requiere seguimiento continuo
• Se descubren nuevos elementos accionables durante la ejecución de la tarea
• Múltiples todos necesitan actualizaciones de estado simultáneamente
• Las tareas complejas se benefician de una visualización clara del progreso

Evita usar cuando:

• Solo hay una tarea única y trivial
• La tarea se puede completar en uno o dos pasos simples
• La solicitud es puramente conversacional o informativa

Ejemplos de Uso

• Al implementar una característica de múltiples componentes que requiere cambios en el frontend, backend y base de datos
• Al depurar problemas que revelan múltiples problemas relacionados que requieren correcciones
• Al configurar entornos de desarrollo con múltiples pasos de configuración
• Al documentar sistemas que requieren fases de investigación, escritura y revisión
• Al refactorizar código que afecta múltiples archivos y requiere pruebas

Ejemplos de Uso

Desglose inicial de tareas:

<update_todo_list>
<todos>
[-] Analizar requisitos y crear especificación técnica
[ ] Diseñar esquema de base de datos y endpoints de API
[ ] Implementar servicio de autenticación backend
[ ] Crear componentes de inicio de sesión frontend
[ ] Escribir pruebas completas
[ ] Actualizar documentación
</todos>
</update_todo_list>

Actualizar el progreso y agregar tareas descubiertas:

<update_todo_list>
<todos>
[x] Analizar requisitos y crear especificación técnica
[x] Diseñar esquema de base de datos y endpoints de API
[-] Implementar servicio de autenticación backend
[ ] Crear componentes de inicio de sesión frontend
[ ] Escribir pruebas completas
[ ] Actualizar documentación
[ ] Agregar funcionalidad de restablecimiento de contraseña
[ ] Implementar limitación de velocidad para intentos de inicio de sesión
</todos>
</update_todo_list>

Completar múltiples tareas y cambiar el enfoque:

<update_todo_list>
<todos>
[x] Analizar requisitos y crear especificación técnica
[x] Diseñar esquema de base de datos y endpoints de API
[x] Implementar servicio de autenticación backend
[x] Crear componentes de inicio de sesión frontend
[-] Escribir pruebas completas
[ ] Actualizar documentación
[ ] Agregar funcionalidad de restablecimiento de contraseña
[ ] Implementar limitación de velocidad para intentos de inicio de sesión
</todos>
</update_todo_list>