| name | execute-task |
| version | 1.0.0 |
| depends_on | ["review"] |
| description | Executa uma tarefa de implementação aprovada por meio de codificação, validação, revisão e captura de evidências. Use quando um arquivo de tarefa estiver pronto para implementação e fechamento com testes, lint e evidência de revisão. Não use para planejamento, refatorações amplas sem tarefa ou exploração especulativa de código. |
Executar Tarefa
Procedimentos
Etapa 1: Validar a elegibilidade da tarefa
- Verificar profundidade de invocação:
source scripts/lib/check-invocation-depth.sh || { echo "failed: depth limit exceeded"; exit 1; } — parar se o limite for atingido.
- Confirmar que
tasks/prd-<feature-slug>/tasks.md, o arquivo de tarefa alvo, prd.md e techspec.md estão presentes.
- Executar gate de cobertura de RF:
bash scripts/check-rf-coverage.sh tasks/prd-<feature-slug>/prd.md tasks/prd-<feature-slug>/tasks.md — parar com blocked se houver RFs não cobertos.
- Selecionar a primeira tarefa elegível apenas quando o usuário não tiver escolhido uma explicitamente.
- Confirmar que todas as dependências da tarefa estão em
done.
- Se a tarefa não for elegível, retornar
needs_input ou blocked.
Etapa 2: Carregar o contexto de implementação
- Ler por completo o arquivo de tarefa selecionado,
prd.md e techspec.md.
- Verificar coerência temporal: se
prd.md ou techspec.md forem mais novos que tasks.md, avisar o usuário e parar com needs_input se não houver confirmação.
- Confirmar que o contrato de carga base definido em
AGENTS.md foi cumprido.
- Se a tarefa tocar código Go, ler também
.agents/skills/go-implementation/SKILL.md e carregar apenas as referências exigidas pela mudança.
- Se a tarefa tocar código Node/TypeScript, ler também
.agents/skills/node-implementation/SKILL.md e carregar apenas as referências exigidas pela mudança.
- Se a tarefa tocar código Python, ler também
.agents/skills/python-implementation/SKILL.md e carregar apenas as referências exigidas pela mudança.
- Mapear objetivo da tarefa, critérios de aceitação, subtarefas e arquivos-alvo antes de editar.
Etapa 3: Executar a etapa de implementação
- Seguir a ordem das subtarefas definida no arquivo de tarefa.
- Implementar testes junto com as mudanças de produção.
- Preferir os pontos de entrada documentados:
task *, depois make *, depois o equivalente local já documentado.
- Rodar validação direcionada após subtarefas relevantes, não apenas no final.
- Registrar comandos executados e arquivos alterados para o relatório.
- Parar com
needs_input se uma decisão obrigatória ou entrada faltante bloquear a conclusão segura.
Etapa 4: Executar a etapa de validação e aprovação
- Seguir Etapa 4 de
.agents/skills/agent-governance/SKILL.md.
- Rodar testes e lint mais amplos quando o escopo justificar.
- Verificar cada critério de aceitação com evidência explícita.
- Invocar
review para o diff produzido e incluir prd.md e techspec.md como contexto.
- Se
review retornar REJECTED com bugs no formato canônico, invocar a skill bugfix para corrigir os achados dentro do escopo da tarefa.
- Após
bugfix, rerodar as validações necessárias e uma nova revisão.
- Aceitar apenas
APPROVED ou APPROVED_WITH_REMARKS como veredito de revisão aprovador final.
Etapa 5: Persistir as evidências
- Ler
assets/task-execution-report-template.md.
- Atualizar o status em
tasks.md para done apenas depois de implementação, validação e revisão concluídas com sucesso.
- Salvar o relatório como
tasks/prd-<feature-slug>/[num]_execution_report.md.
- Rodar
.claude/scripts/validate-task-evidence.sh no relatório salvo.
- Se o validador de evidências falhar, retornar
blocked e descrever a evidência ausente.
- Antes de marcar a task como
done em tasks.md, executar bash scripts/check-task-completion.sh tasks/prd-<feature-slug>/ — parar com blocked se houver violações.
Etapa 6: Encerrar explicitamente
- Informar o status da tarefa, os resultados de validação, o veredito do revisor e o caminho do relatório.
- Retornar
done, blocked, failed ou needs_input usando apenas nomes de estado canônicos.
Tratamento de Erros
- Se o arquivo de tarefa estiver desatualizado em relação ao codebase ou à especificação técnica, parar e expor o descompasso antes de editar código.
- Se a automação do repositório não tiver entrypoints
task ou make, descobrir e usar os comandos locais documentados em vez de adivinhar.
- Se as validações falharem, tentar apenas uma remediação limitada. Se o problema for mais profundo, retornar
failed com o comando bloqueante exato e um diagnóstico curto.
- Respeitar o limite de profundidade de invocação definido em
.agents/skills/agent-governance/SKILL.md. Se review invocar bugfix e bugfix precisar de nova review, esta é a profundidade máxima — não re-invocar bugfix a partir dessa segunda review.
