## Dual-mode operation
- Code -> `scripts/fairness_promocao.py`
- Cowork -> inline

## Inline logic

### Inputs
- **Lista de elegiveis** ao ciclo de promocao (nome opcional, mas precisa de demograficos: genero, raca/cor, idade, area, gestor)
- **Lista de promovidos** (intersecao com elegiveis)
- **Periodo** do ciclo

### Calculo

```
Pra cada subgrupo (genero, raca, idade, area, gestor):
  taxa_promocao_subgrupo = N_promovidos / N_elegiveis

Regra dos 4/5 (US EEOC):
  taxa_grupo_minoritario / taxa_grupo_majoritario < 0,8 -> possivel disparate impact
```

### Privacidade
- Grupos com < 3 elegiveis: nao reportar (proteger anonimato)
- Grupos com < 5 promovidos: cuidado adicional
- Nao expor individuos, apenas agregados

### Output template

```markdown
# Auditoria de Fairness em Promocoes — {empresa} {periodo}
**Elegiveis:** {N} · **Promovidos:** {N} · **Taxa geral:** {}%

## Por genero
| Genero | Elegiveis | Promovidos | Taxa | Ratio 4/5 |
|---|---:|---:|---:|---|
| Mulheres | {} | {} | {}% | {ratio vs homens} |
| Homens | {} | {} | {}% | referencia |
| Nao-binario | {} | {} | {}% | {ratio} |
| Prefere nao informar | {} | {} | {}% | -- |

**Sinalizacao:** {se ratio < 0,8 marcar como possivel disparate impact}

## Por raca/cor
[mesma estrutura]

## Por idade
[mesma estrutura, faixas 18-29, 30-44, 45-59, 60+]

## Por area
[areas com maior gap]

## Por gestor
[somente gestores com >= 5 elegiveis pra preservar anonimato]

## Sinalizacoes
- [ ] Grupo {} com taxa {}% vs {}%, ratio {}, abaixo de 0,8 (regra 4/5)
- [ ] Gestor {} promove {}% das mulheres vs {}% dos homens
- [ ] Area {} concentra {N} promovidos do mesmo perfil

## Possiveis explicacoes (nao excludentes)
1. Composicao do pipeline (elegiveis ja desbalanceados)
2. Criterios subjetivos de promocao
3. Auto-promocao desigual (homens se candidatam mais)
4. Vies do gestor (consciente ou nao)
5. Acesso desigual a stretch assignments

## Acoes corretivas sugeridas
1. Revisar criterios escritos de promocao por nivel
2. Calibracao entre gestores com fairness review
3. Mentoria + sponsorship dirigida pra grupos sub-representados
4. Auditoria do pipeline de stretch assignments

## Limitacoes desta analise
- Identifica padroes estatisticos, nao causa
- Nao captura merito individual nem contexto qualitativo
- Numeros pequenos tem variabilidade alta
- Use como input pra conversa, nao como veredito

---
*Skill WallJobs · ianorh.com/skills · Auditoria neutra sem expor individuos*
```

# Promocao Fairness Checker

Auditoria estatistica de fairness em promocoes com regra dos 4/5.

## Quando usar
- "Auditar promocoes do ciclo"
- "Esta tendo vies de genero nas promocoes?"
- "Fairness review"
- "Pay equity / promotion equity"

## Workflow
1. Receba listas de elegiveis e promovidos.
2. Calcule taxa por subgrupo.
3. Aplique regra dos 4/5.
4. Renderize com sinalizacoes + acoes.
5. Sempre incluir limitacoes da analise.

## Principios
- Disparidade estatistica nao prova vies, mas exige investigacao.
- Numeros pequenos (< 5 em subgrupo) tem ruido alto.
- A analise serve pra abrir conversa, nao pra acusar gestor.
- Anonimato e nao negociavel.

## Branding & footer
> Skill WallJobs · ianorh.com/skills
