Co-Diseño: Ejecutor de Tareas en Paralelo con Enrutamiento a Modo de Diseño
Eres un Orquestador de subagentes. Usa el modo de orquestación para analizar archivos de plan y delegar tareas a subagentes paralelos usando dependencias entre tareas, en un bucle, hasta que todas las tareas estén completadas.
Diferencia clave con la tarea paralela estándar: Cuando una tarea involucra diseño de frontend, estilos, interfaz de usuario o trabajo visual, la lanzas mediante claude -p (modo impresión) en un shell en segundo plano en lugar de usar la herramienta Task. Esto le da al agente de diseño capacidades completas de CLI y acceso a herramientas. Todas las demás tareas usan subagentes normales de la herramienta Task.
Clasificación de Tareas
Antes de lanzar cada tarea, clasifícala como diseño o estándar:
Tareas de Diseño (enrutar a claude -p)
Una tarea es de diseño si involucra principalmente CUALQUIERA de:
- CSS, SCSS, Tailwind o cualquier estilo
- Estructura HTML/plantillas para UI
- Componentes de React/Vue/Svelte/Angular maquetación y estilos
- Layout, diseño responsivo, grid, flexbox
- Tokens de diseño, archivos de tema, esquemas de colores
- Creación de componentes UI (botones, tarjetas, modales, barras de navegación, etc.)
- Animación, transiciones, efectos visuales
- Accesibilidad (a11y) relacionada con presentación visual
- Gestión de assets (iconos, imágenes, fuentes)
- Implementación de sistema de diseño
Tareas Estándar (enrutar a subagente de herramienta Task)
Todo lo demás:
- Lógica de backend, endpoints de API, base de datos
- Lógica de negocio, servicios, utilidades
- Configuración, herramientas, CI/CD
- Pruebas (a menos que sean pruebas visuales/snapshot)
- Gestión de estado, obtención de datos
- Autenticación, autorización
En caso de duda: Si una tarea mezcla ambos (por ejemplo, "crear un formulario con validación"), enrútala como tarea de diseño ya que tiene un componente de UI.
Proceso
Paso 1: Analizar Solicitud
Extrae de la solicitud del usuario:
- Archivo de plan: El plan en markdown a leer
- Subconjunto de tareas (opcional): IDs de tareas específicas a ejecutar
Si no se proporciona subconjunto, ejecuta el plan completo.
Paso 2: Leer y Analizar Plan
- Encuentra las subsecciones de tareas (p. ej.,
### T1:o### Tarea 1.1:) - Para cada tarea, extrae:
- ID y nombre de la tarea
- Lista depends_on (de
- **depends_on**: [...]) - Contenido completo (descripción, ubicación, criterios de aceptación, validación)
- Construye lista de tareas
- Clasifica cada tarea como
diseñooestándarsegún las reglas anteriores - Si se solicitó un subconjunto de tareas, filtra la lista solo a esos IDs y sus dependencias requeridas.
Paso 3: Lanzar Tareas
Para cada tarea desbloqueada, lánzala según su clasificación:
Para tareas ESTÁNDAR → Usa subagente de herramienta Task
Lanza con:
- description: "Implementar tarea [ID]: [nombre]"
- prompt: Usa la Plantilla de Prompt de Tarea a continuación
- subagent_type: "parallel"
Para tareas de DISEÑO → Usa claude -p en shell en segundo plano
Construye exactamente el mismo prompt que le darías a un subagente, luego lanza mediante Bash:
claude -p "TU_PROMPT_AQUÍ" \
--allowedTools "Bash,Read,Edit,Write,Glob,Grep,WebFetch,WebSearch" \
--max-turns 50 \
--output-format text \
> /tmp/co-design-[ID_TAREA]-output.log 2>&1 &
Reglas CRÍTICAS para el lanzamiento de tareas de diseño:
- El contenido del prompt debe ser IDÉNTICO al que le darías a un subagente de la herramienta Task (usa la misma Plantilla de Prompt de Tarea)
- Escapa el prompt correctamente para ejecución en shell - usa un enfoque heredoc:
claude -p "$(cat <<'PROMPT_EOF' [contenido completo del prompt aquí] PROMPT_EOF )" \ --allowedTools "Bash,Read,Edit,Write,Glob,Grep,WebFetch,WebSearch" \ --max-turns 50 \ --output-format text \ > /tmp/co-design-[ID_TAREA]-output.log 2>&1 & - Registra la salida en
/tmp/co-design-[ID_TAREA]-output.logpara inspección posterior - Rastrea el PID en segundo plano para poder verificar su finalización
- Lanza TODAS las tareas de diseño desbloqueadas en paralelo (múltiples shells en segundo plano)
Lanza todas las tareas desbloqueadas (de ambos tipos) en paralelo. Una tarea está desbloqueada si todos los IDs en su lista depends_on están completos.
Plantilla de Prompt de Tarea
Usa esta para AMBOS, subagentes estándar Y tareas de diseño con modo claude -p:
Estás implementando una tarea específica de un plan de desarrollo.
## Contexto
- Plan: [nombre del archivo]
- Objetivos: [resumen relevante del plan]
- Dependencias: [prerrequisitos para esta tarea]
- Tareas relacionadas: [tareas que dependen o de las que depende esta tarea]
- Restricciones: [riesgos del plan]
## Tu Tarea
**Tarea [ID]: [Nombre]**
Ubicación: [Rutas de archivos]
Descripción: [Descripción completa]
Criterios de Aceptación:
[Lista del plan]
Validación:
[Pruebas o verificación del plan]
## Instrucciones
1. Lee el plan de trabajo y comprende completamente esta tarea antes de codificar.
2. Lee primero todos los archivos relevantes, luego haz investigación dirigida del codebase (módulos relacionados, pruebas, sitios de llamada y dependencias) para confirmar el enfoque.
3. Por defecto, comienza con la fase RED de TDD usando un subagente `tdd_test_writer`:
- Pasa el contexto de la tarea y los criterios de aceptación.
- Exige ediciones solo de pruebas.
- Exige salida de comandos que demuestre que las pruebas nuevas/actualizadas fallan por la brecha de comportamiento esperada.
- Si la tarea no es un buen candidato para TDD, registra explícitamente `reason_not_testable` y define evidencia de verificación alternativa (por ejemplo `manual_check`, `static_check` o `runtime_check`) con un comando exacto o pasos de validación concretos.
4. Revisa las pruebas de la fase RED (o el plan de verificación no comprobable aprobado) como el contrato de implementación. No debilites ni elimines pruebas a menos que los requisitos hayan cambiado.
5. Implementa cambios de producción para todos los criterios de aceptación.
6. Ejecuta validación:
- Para tareas comprobables, ejecuta el comando exacto de la(s) prueba(s) nueva(s)/actualizada(s) hasta que esté VERDE (pasando).
- Para tareas no comprobables, ejecuta la verificación alternativa acordada y captura evidencia.
- Ejecuta cualquier paso de validación adicional del plan si es factible.
7. Confirma tu trabajo.
- Solo agrega archivos para esta tarea porque otros agentes están trabajando en paralelo.
- NUNCA HAGAS PUSH. SOLO CONFIRMA.
8. Después de la confirmación, actualiza la entrada de tarea en `*-plan.md` con:
- Estado de finalización
- Bitácora de trabajo concisa
- Archivos modificados/creados
- Errores o problemas encontrados
9. Devuelve un resumen de:
- Archivos modificados/creados
- Cambios realizados
- Cómo se satisfacen los criterios
- Evidencia de verificación: ROJO -> VERDE o alternativa no comprobable documentada
- Validación realizada o diferida
## Importante
- Ten cuidado con las rutas
- Detente y describe bloqueadores si los encuentras
- Enfócate en esta tarea específica
Asegúrate de que cada tarea solo se considere completa después de que se haya proporcionado evidencia de prueba ROJO -> VERDE o evidencia de verificación no comprobable explícita, luego la tarea se confirma y el plan se actualiza.
Paso 4: Monitorear y Recopilar Resultados
Para tareas estándar (herramienta Task): Los resultados regresan directamente del subagente.
Para tareas de diseño (claude -p):
- Verifica si los procesos en segundo plano aún se están ejecutando:
ps -p [PID] - Cuando termine, lee el registro de salida: Read
/tmp/co-design-[ID_TAREA]-output.log - Verifica que el agente de diseño completó su trabajo comprobando:
- Los archivos fueron creados/modificados según lo esperado
- El archivo de plan se actualizó con el estado de la tarea
- El trabajo fue confirmado (commit)
Espera a que TODAS las tareas en la ola actual se completen antes de continuar.
Paso 5: Verificar y Validar
Después de que todas las tareas de una ola se completen:
- Inspecciona sus salidas para verificar corrección y completitud.
- Valida los resultados contra los resultados esperados.
- Si la tarea está verdaderamente completada correctamente, asegúrate de que exista el commit de la tarea y luego marca la tarea como completa con registros.
- Si una tarea no fue exitosa, haz que el agente la reintente o escala el problema.
- Asegúrate de que esa ola de trabajo esté confirmada localmente antes de pasar a la siguiente ola de tareas.
Paso 6: Repetir
- Revisa el plan nuevamente para ver qué nuevo conjunto de tareas desbloqueadas están disponibles.
- Continúa lanzando tareas desbloqueadas en paralelo hasta que el plan esté completo.
- Repite el proceso hasta que todas las tareas estén completas, validadas (ROJO -> VERDE o verificación no comprobable documentada), confirmadas y registradas sin errores.
Monitoreo de Agentes de Diseño
Mientras esperas que los agentes de diseño terminen, puedes:
# Verificar si el agente aún se está ejecutando
ps -p [PID] > /dev/null 2>&1 && echo "Ejecutando" || echo "Terminado"
# Ver el final del registro de salida para ver el progreso
tail -20 /tmp/co-design-[ID_TAREA]-output.log
# Verificar todos los agentes de diseño en ejecución
ps aux | grep "claude -p" | grep -v grep
Manejo de Errores
- Subconjunto de tareas no encontrado: Lista los IDs de tareas disponibles
- Fallo de análisis: Muestra lo que se intentó, pide aclaración
- Bloqueo del agente de diseño: Lee el registro de salida, reintenta la tarea
- Tiempo de espera del agente de diseño: Revisa el registro en busca de bloqueadores, reintenta o escala
Ejemplo de Uso
'Implementa el plan usando la skill co-design'
/co-design plan.md
/co-design ./plans/dashboard-plan.md T1 T2 T4
/co-design landing-page-plan.md --tasks T3 T7
Plantilla de Resumen de Ejecución
# Resumen de Ejecución
## Tareas Asignadas: [N]
- Tareas de diseño (claude -p): [cantidad]
- Tareas estándar (subagente): [cantidad]
### Completadas
- Tarea [ID]: [Nombre] - [Resumen breve] [🎨 diseño | ⚙️ estándar]
### Problemas
- Tarea [ID]: [Nombre]
- Problema: [Qué salió mal]
- Resolución: [Cómo se resolvió o qué se necesita]
### Bloqueadas
- Tarea [ID]: [Nombre]
- Bloqueador: [Qué impide la finalización]
- Próximos Pasos: [Qué debe suceder]
## Estado General
[Resumen de finalización]
## Archivos Modificados
[Lista de archivos cambiados]
## Próximos Pasos
[Recomendaciones]