name: evidencias-e-eventos
description: Use para implementar registro de evidências, eventos de domínio e listeners no Laravel.
Instruções da Skill
Implemente fatos imutáveis e eventos explícitos, respeitando o ciclo de vida do Laravel.
O agente deve priorizar:
- Clareza semântica
- Auditabilidade
- Reconstrução de estado por eventos
Regras e Passos
-
Modelagem (M):
- Defina o que é Evidência e o que não é.
- Garanta imutabilidade por código (model boot / constraints).
-
Ação (A):
- Crie Actions (casos de uso) para registrar evidências.
- Utilize o Service Container para injeção de dependências.
-
Lógica (L):
- Dispare eventos de domínio (
EvidenceRecorded, CycleClosed).
- Não calcule scores dentro da Action.
-
Teste (T):
-
Crie testes que validem:
- Evidência não pode ser alterada
- Evento é disparado corretamente
Uso de Ferramentas
- Use
php artisan make:event e make:listener apenas após validação conceitual.
- Prefira Pest para testes.