home / skills / victorsmaniotto / degestao / agregadores-calculo
npx playbooks add skill victorsmaniotto/degestao --skill agregadores-calculoReview the files below or copy the command above to add this skill to your agents.
---
name: agregadores-performance-potencial
description: Use para implementar serviços de agregação que calculam os eixos de Performance e Potencial a partir de evidências.
--------------------------------------------------------------------------------------------------------------------------------
# Instruções da Skill
Implemente **serviços puros**, determinísticos e testáveis.
Agregadores **não escrevem no banco** e **não conhecem UI**.
## Regras e Passos
1. **Modelagem (M):**
* Identifique dimensões do eixo (ex.: Entrega, Qualidade, Autonomia).
* Defina pesos e normalização por complexidade de contexto.
2. **Lógica (L):**
* Implemente agregadores separados:
* `PerformanceAggregator`
* `PotentialAggregator`
* Garanta a regra: *Potencial só cresce com progressão de complexidade*.
3. **Integração:**
* Receba evidências via eventos.
* Retorne DTOs (`AxesResult`), nunca Models.
4. **Teste (T):**
* Teste cálculos com múltiplos contextos e ciclos.
* Teste teto de potencial sem progressão.
## Uso de Ferramentas
* Use classes em `app/Domains/Aggregation`.
* Não use Eloquent dentro dos testes de cálculo (prefira mocks ou collections).