workflow-patterns

Visión General

¿Qué es workflow-patterns?

workflow-patterns es una skill diseñada para ayudar a desarrolladores y equipos a implementar flujos de trabajo estructurados de desarrollo guiado por pruebas (TDD) dentro de proyectos basados en git. Proporciona un proceso claro para gestionar tareas, puntos de control por fases, commits de git y protocolos de verificación, asegurando calidad y trazabilidad durante todo el ciclo de desarrollo.

¿Quién Debería Usar Esta Skill?

• Desarrolladores que siguen prácticas TDD
• Equipos que gestionan proyectos complejos con múltiples fases
• Cualquier persona que necesite rastrear el progreso y aplicar controles de calidad usando git
• Colaboradores que trabajan con archivos plan.md de Conductor

Problemas que Resuelve

• Garantiza que las tareas se completen en orden y se registren en archivos plan
• Aplica el ciclo TDD rojo-verde-refactor para cada tarea
• Estandariza prácticas de commits git para estado e implementación de tareas
• Integra protocolos de verificación para asegurar la calidad

Cómo Usar

Pasos de Instalación

1. Instala la skill usando el siguiente comando:

   npx skills add https://github.com/wshobson/agents --skill workflow-patterns

2. Revisa la documentación principal en SKILL.md para una guía detallada del flujo de trabajo.

Primeros Pasos

• Comienza con el archivo plan.md de tu proyecto para identificar tareas pendientes.
• Sigue el ciclo de vida TDD:
  1. Selecciona la siguiente tarea [ ] en orden.
  2. Márcala como [~] (en progreso) en plan.md y haz un commit de este cambio por separado.
  3. Escribe pruebas que fallen (fase ROJA) antes de implementar.
  4. Implementa la tarea para pasar las pruebas (fase VERDE).
  5. Refactoriza según sea necesario (fase REFACTOR).
  6. Actualiza plan.md a [x] (completada) y haz commit.
  7. Sigue los protocolos de verificación según lo indicado en la documentación.

Estructura de Archivos y Referencias Clave

• SKILL.md: Guía principal del flujo de trabajo
• plan.md: Seguimiento y actualización del estado de tareas
• README.md, AGENTS.md, metadata.json: Contexto adicional y metadatos
• rules/, resources/, references/, scripts/: Archivos de soporte para uso avanzado

Buenas Prácticas

• Siempre haz commits de cambios en el estado de tareas por separado de los cambios de código
• No avances fases sin completar las tareas en orden
• Usa mensajes de commit claros para documentar progreso y verificaciones

Preguntas Frecuentes

¿Cuándo es adecuado usar workflow-patterns?

Usa workflow-patterns cuando necesites un flujo disciplinado y repetible para TDD y gestión de tareas en proyectos git, especialmente si trabajas con archivos plan.md de Conductor o listas de tareas estructuradas similares.

¿Puedo usar workflow-patterns fuera de Conductor?

Sí, aunque está optimizado para Conductor, el flujo y las prácticas de commit pueden adaptarse a cualquier proyecto basado en git que se beneficie de TDD estructurado y seguimiento de tareas.

¿Qué archivos debo revisar primero?

Comienza con SKILL.md para una visión general del flujo, luego revisa plan.md para la lista de tareas de tu proyecto. Explora las carpetas de soporte para configuraciones avanzadas.

¿workflow-patterns automatiza comandos git?

No, workflow-patterns proporciona un proceso y documentación para gestionar tareas y commits, pero no automatiza operaciones git. Deberás ejecutar los comandos git manualmente siguiendo el flujo.

¿Dónde puedo encontrar más detalles?

Abre la pestaña de Archivos en el repositorio para explorar toda la documentación, referencias y scripts auxiliares para un entendimiento y personalización más profundos.