Communitygithub.com

am-wills/swarms

Solo se activa mediante comandos explícitos /co-design. Ejecutor de tareas en paralelo que enruta tareas de frontend/diseño al modo de impresión de Claude CLI para obtener resultados de diseño superiores.

¿Qué es swarms?

Esta skill convierte al agente en un orquestador de subagentes capaz de ejecutar planes de desarrollo en paralelo, clasificando cada tarea como 'estándar' o 'de diseño'. Las tareas de diseño (CSS, componentes UI, layouts, etc.) se lanzan mediante `claude -p` en un shell en segundo plano, aprovechando todas las herramientas de la CLI de Claude para generar resultados visuales de alta calidad. Las tareas estándar (lógica de backend, configuración, etc.) se delegan al sistema de subagentes por tareas. La skill soporta dependencias entre tareas, ejecución por lotes, monitoreo de agentes de diseño en segundo plano, validación RED->GREEN (o verificación alternativa documentada), y generación de resúmenes de ejecución. Está diseñada para Claude Code y entornos donde la CLI de Claude está disponible, ideal para implementar planes de proyecto completos que mezclen frontend y backend en un solo flujo orquestado.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/am-will/swarms/tree/HEAD/skills/co-design

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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:

  1. Archivo de plan: El plan en markdown a leer
  2. 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

  1. Encuentra las subsecciones de tareas (p. ej., ### T1: o ### Tarea 1.1:)
  2. 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)
  3. Construye lista de tareas
  4. Clasifica cada tarea como diseño o estándar según las reglas anteriores
  5. 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:

  1. 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)
  2. 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 &
    
  3. Registra la salida en /tmp/co-design-[ID_TAREA]-output.log para inspección posterior
  4. Rastrea el PID en segundo plano para poder verificar su finalización
  5. 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):

  1. Verifica si los procesos en segundo plano aún se están ejecutando: ps -p [PID]
  2. Cuando termine, lee el registro de salida: Read /tmp/co-design-[ID_TAREA]-output.log
  3. 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:

  1. Inspecciona sus salidas para verificar corrección y completitud.
  2. Valida los resultados contra los resultados esperados.
  3. 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.
  4. Si una tarea no fue exitosa, haz que el agente la reintente o escala el problema.
  5. Asegúrate de que esa ola de trabajo esté confirmada localmente antes de pasar a la siguiente ola de tareas.

Paso 6: Repetir

  1. Revisa el plan nuevamente para ver qué nuevo conjunto de tareas desbloqueadas están disponibles.
  2. Continúa lanzando tareas desbloqueadas en paralelo hasta que el plan esté completo.
  3. 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]

Skills relacionados