home / skills / victorsmaniotto / degestao / evidencias-eventos

evidencias-eventos skill

/.agent/skills/evidencias-eventos

npx playbooks add skill victorsmaniotto/degestao --skill evidencias-eventos

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
1.1 KB
---

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

1. **Modelagem (M):**

   * Defina o que é Evidência e o que não é.
   * Garanta imutabilidade por código (model boot / constraints).

2. **Ação (A):**

   * Crie Actions (casos de uso) para registrar evidências.
   * Utilize o Service Container para injeção de dependências.

3. **Lógica (L):**

   * Dispare eventos de domínio (`EvidenceRecorded`, `CycleClosed`).
   * Não calcule scores dentro da Action.

4. **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.