Patrones de Agente
Descripción General
Agent Patterns define el protocolo de coordinación para la ejecución de sprints multi-agente dentro del plugin Sprint. Gobierna cómo el arquitecto del proyecto genera agentes de implementación y pruebas, cómo los agentes comunican resultados a través de informes estructurados y cómo los agentes paralelos evitan conflictos.
Requisitos Previos
- Plugin Sprint instalado y configurado (
/plugin install sprint) - Directorio Sprint inicializado en
.claude/sprint/[N]/ specs.mdescrito con alcance claro y configuración de pruebas- Familiaridad con el ciclo de vida de la fase de sprint (ver la habilidad
sprint-workflow)
Instrucciones
- Estructura cada generación de agente utilizando el formato SPAWN REQUEST. Incluye el nombre del agente, el archivo de especificaciones que debe leer y cualquier restricción de alcance:
SPAWN REQUEST Agent: python-dev Specs: .claude/sprint/1/backend-specs.md Contract: .claude/sprint/1/api-contract.md Scope: Authentication endpoints only - Asegúrate de que cada agente generado reciba solo los archivos relevantes para su alcance. Pasa el
api-contract.mdcomo interfaz compartida para que los agentes de backend y frontend se mantengan sincronizados. - Recopila informes estructurados de cada agente al finalizar. Cada informe debe incluir: trabajo completado, archivos modificados, pruebas añadidas y estado de conformidad con la especificación.
- Al ejecutar agentes en paralelo, divide el trabajo por límites de dominio (por ejemplo, backend vs. frontend vs. CI/CD). Nunca asignes rutas de archivo superpuestas a agentes concurrentes.
- Envía los informes de los agentes al arquitecto del proyecto para su revisión. El arquitecto decide si iterar (regenerar con especificaciones reducidas) o avanzar a la siguiente fase.
- Para agentes de pruebas, pasa el formato de informe de pruebas de IU que se muestra en
${CLAUDE_SKILL_DIR}/references/ui-test-report.mdpara que los resultados sigan un esquema consistente que incluya recuentos de pruebas, cobertura, fallos y errores de consola.
Salida
- Bloques SPAWN REQUEST consumidos por el orquestador de sprint para lanzar agentes
- Informes de agente estructurados que contienen: resumen, archivos cambiados, resultados de pruebas y estado de conformidad
- Informes de pruebas de IU con recuentos de aprobados/reprobados, detalles de cobertura, descripciones de fallos y registros de errores de consola
status.mdactualizado que refleja el trabajo completado y restante después de cada iteración
Manejo de Errores
| Error | Causa | Solución |
|---|---|---|
| El agente recibe un archivo de especificaciones incorrecto | Ruta incorrecta en SPAWN REQUEST | Verifica el número de directorio del sprint y el nombre del archivo antes de generar |
| Modificaciones de archivo superpuestas de agentes paralelos | Límites de alcance no definidos claramente | Divide el trabajo por dominio; asigna directorios distintos a cada agente |
| El informe del agente carece de campos obligatorios | Las instrucciones del agente carecen del formato del informe | Incluye la plantilla de informe estructurado en el prompt del agente |
| Bucle de iteración infinito | Las especificaciones nunca se satisfacen por completo | Revisa status.md para problemas de bloqueo; el orquestador se pausa después de 5 iteraciones |
| Agente no encontrado | Nombre del agente mal escrito en SPAWN REQUEST | Verifica que los archivos markdown del agente existan en el directorio agents/ |
Ejemplos
Generación de agentes de implementación en paralelo:
SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md
SPAWN REQUEST
Agent: nextjs-dev
Specs: .claude/sprint/1/frontend-specs.md
Contract: .claude/sprint/1/api-contract.md
Ambos agentes comparten el mismo api-contract.md para garantizar la compatibilidad de la API.
Formato de informe de agente estructurado:
AGENT REPORT
Agent: python-dev
Status: COMPLETE
Files Modified: src/auth/routes.py, src/auth/models.py, tests/test_auth.py
Tests: 12 passed, 0 failed
Conformity: All backend-specs requirements implemented
Notes: JWT token expiry set to 24h per spec
Coordinación de agentes de pruebas:
SPAWN REQUEST
Agent: qa-test-agent
Specs: .claude/sprint/1/specs.md
Run After: python-dev, nextjs-dev
SPAWN REQUEST
Agent: ui-test-agent
Specs: .claude/sprint/1/specs.md
Run After: qa-test-agent
Recursos
${CLAUDE_SKILL_DIR}/references/ui-test-report.md-- Formato de informe de pruebas de IU estructurado con seguimiento de cobertura y fallos- Habilidad del flujo de trabajo de Sprint para el contexto del ciclo de vida de la fase
- Habilidad de contrato de API para el diseño de interfaz compartida
- README del plugin Sprint para una visión general de la arquitectura del agente