Padrões de Agente
Visão Geral
Padrões de Agente define o protocolo de coordenação para execução de sprints multi-agente dentro do plugin Sprint. Ele rege como o arquiteto do projeto cria agentes de implementação e teste, como os agentes comunicam resultados via relatórios estruturados e como agentes paralelos evitam conflitos.
Pré-requisitos
- Plugin Sprint instalado e configurado (
/plugin install sprint) - Diretório Sprint inicializado em
.claude/sprint/[N]/ specs.mdescrito com escopo claro e configuração de teste- Familiaridade com o ciclo de vida das fases do sprint (veja a habilidade
sprint-workflow)
Instruções
- Estruture cada criação de agente usando o formato SPAWN REQUEST. Inclua o nome do agente, o arquivo de especificação que ele deve ler e quaisquer restrições de escopo:
SPAWN REQUEST Agent: python-dev Specs: .claude/sprint/1/backend-specs.md Contract: .claude/sprint/1/api-contract.md Scope: Authentication endpoints only - Garanta que cada agente criado receba apenas os arquivos relevantes ao seu escopo. Passe o
api-contract.mdcomo uma interface compartilhada para que os agentes de backend e frontend permaneçam sincronizados. - Colete relatórios estruturados de cada agente após a conclusão. Cada relatório deve incluir: trabalho concluído, arquivos modificados, testes adicionados e status de conformidade com a especificação.
- Ao executar agentes em paralelo, particione o trabalho por limite de domínio (ex.: backend vs. frontend vs. CI/CD). Nunca atribua caminhos de arquivo sobrepostos a agentes concorrentes.
- Alimente os relatórios dos agentes de volta para o arquiteto do projeto para revisão. O arquiteto decide se itera (recria com especificações reduzidas) ou avança para a próxima fase.
- Para agentes de teste, passe o formato de relatório de teste de IU mostrado em
${CLAUDE_SKILL_DIR}/references/ui-test-report.mdpara que os resultados sigam um esquema consistente incluindo contagens de teste, cobertura, falhas e erros de console.
Saída
- Blocos SPAWN REQUEST consumidos pelo orquestrador do sprint para iniciar agentes
- Relatórios de agente estruturados contendo: resumo, arquivos alterados, resultados de teste e status de conformidade
- Relatórios de teste de IU com contagens de aprovação/reprovação, detalhes de cobertura, descrições de falhas e logs de erro do console
status.mdatualizado refletindo o trabalho concluído e restante após cada iteração
Tratamento de Erros
| Erro | Causa | Solução |
|---|---|---|
| Agente recebe arquivo de especificação errado | Caminho incorreto no SPAWN REQUEST | Verifique o número do diretório do sprint e o nome do arquivo antes de criar |
| Modificações de arquivo sobrepostas de agentes paralelos | Limites de escopo não definidos claramente | Particione o trabalho por domínio; atribua diretórios distintos a cada agente |
| Relatório de agente faltando campos obrigatórios | Instruções do agente sem formato de relatório | Inclua o template de relatório estruturado no prompt do agente |
| Loop de iteração infinito | Especificações nunca totalmente satisfeitas | Verifique status.md para problemas bloqueantes; o orquestrador pausa após 5 iterações |
| Agente não encontrado | Nome do agente com erro de digitação no SPAWN REQUEST | Verifique se os arquivos markdown do agente existem no diretório agents/ |
Exemplos
Criando agentes de implementação paralelos:
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 os agentes compartilham o mesmo api-contract.md para garantir compatibilidade de API.
Formato de relatório de agente estruturado:
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
Coordenação de agente de teste:
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 relatório de teste de IU estruturado com rastreamento de cobertura e falhas- Habilidade de fluxo de trabalho do Sprint para contexto do ciclo de vida das fases
- Habilidade de contrato de API para design de interface compartilhada
- README do plugin Sprint para visão geral da arquitetura do agente