Contextor Implement
Ejecuta las tareas del track activo siguiendo el plan.
Argumento opcional: $ARGUMENTS (nombre específico del track, si no se proporciona usa el más reciente)
Prerequisitos
- •Verifica que exista al menos un track en
contextor/tracks/ - •Verifica que el track tenga
spec.mdyplan.md - •Verifica que el plan tenga tareas pendientes
[ ]
Si no hay tracks o todos están completados, indica al usuario que ejecute /contextor-newtrack.
Proceso
Fase 1: Identificar Track Activo
Si se proporcionó nombre:
- •Usa
contextor/tracks/{nombre}/
Si no se proporcionó:
- •Busca el track más reciente con tareas pendientes
- •Un track está "pendiente" si tiene
[ ]en su plan.md
Fase 2: Cargar Contexto
Lee en orden:
- •
contextor/product.md- Entender el producto - •
contextor/tech-stack.md- Tecnologías permitidas - •
contextor/workflow.md- Proceso a seguir - •
contextor/guidelines.md- Estándares de código - •
contextor/tracks/{track}/spec.md- Requisitos - •
contextor/tracks/{track}/plan.md- Tareas a ejecutar
Fase 3: Ejecutar Tareas
Para cada fase en el plan:
- •
Anunciar fase: "Iniciando Fase X: {nombre}"
- •
Por cada tarea pendiente
[ ]:- •Lee la descripción de la tarea
- •Implementa según spec y guidelines
- •Si workflow indica TDD: escribe test primero, luego código
- •Verifica que funciona
- •Actualiza
plan.md: cambia[ ]a[x] - •Haz commit con mensaje semántico
- •
Reportar progreso: "Fase X completada (Y/Z tareas)"
Fase 4: Commits Atómicos
Formato de commits según workflow.md:
code
{tipo}({track}): {descripción}
- {detalle 1}
- {detalle 2}
Track: {nombre-track}
Tarea: {número}
Tipos comunes:
- •
feat: nueva funcionalidad - •
fix: corrección de bug - •
refactor: mejora sin cambio funcional - •
test: añadir o modificar tests - •
docs: documentación
Fase 5: Verificación Final
Cuando todas las tareas estén completadas:
- •Verifica que todos los tests pasen
- •Actualiza el estado del track a "Completado"
- •Muestra resumen:
- •Tareas completadas
- •Archivos creados/modificados
- •Commits realizados
Fase 6: Post-Implementación
Marca las tareas de post-implementación en plan.md:
- • Tests pasan → [x] Tests pasan
- • Documentación actualizada → [x] Documentación actualizada
Sugiere al usuario:
- •Revisar los cambios
- •Ejecutar tests adicionales si es necesario
- •Crear PR si corresponde
Manejo de Errores
Si una tarea falla:
- •NO marques como completada
- •Documenta el error en plan.md bajo la tarea
- •Pregunta al usuario cómo proceder:
- •Reintentar
- •Saltar temporalmente
- •Abortar implementación
Notas
- •Nunca escribas código sin leer el contexto completo
- •Respeta estrictamente el tech-stack definido
- •Sigue los guidelines de código
- •Cada tarea = un commit (atómico)
- •Si el workflow indica TDD, escribe tests ANTES del código
- •Actualiza plan.md después de cada tarea completada