name: hr-initiative-roi description: "Business case e ROI de uma iniciativa de People pra ganhar buy-in de CFO/CEO. Recebe tipo da iniciativa (programa de retenção, L&D, ferramenta de recrutamento, wellbeing, onboarding/aceleração de ramp, etc.), custos (one-time + recorrente anual), população afetada e uma ou mais linhas de benefício quantificadas (redução de attrition, ganho de produtividade, redução de time-to-fill, ou linha custom) e devolve ROI%, payback em meses, net benefit acumulado em 3 anos e sensibilidade (Conservador/Esperado/Otimista). Mantida pela Comp. Dual-mode: works in Claude Code (Python script + rich HTML) AND Claude Cowork (inline calculation + markdown, plus HTML artifact when available). Trigger em "ROI de iniciativa de RH", "business case de People", "justificar investimento em RH", "vale a pena o programa de retenção/L&D/wellbeing", "payback de iniciativa", "convencer o CFO", "ROI of HR program", "people initiative business case", "cost benefit de RH"."
HR Initiative ROI
HTML pelo design system (obrigatório). Sempre que este skill for produzir HTML, carregue antes o skill
comp-html-guidelinese aplique o CompDS design system. Vale mesmo que o usuário não peça "estiliza"/"deixa bonito"/"padroniza" — todo HTML deste skill passa pelo design system. Isso não altera a metodologia abaixo; governa só a camada visual do HTML.
Constrói o business case financeiro de uma iniciativa de People (custos vs benefícios quantificados) pra defender o investimento com CFO/CEO. Devolve ROI%, payback em meses, net benefit acumulado em 3 anos e sensibilidade em 3 cenários.
Dual-mode operation (Code + Cowork)
- Claude Code:
python3 scripts/initiative_roi.py ... --output roi.htmlgera headline (ROI/payback/net 3a), barras custo vs benefício com marcador de payback, tabela de benefícios e sensibilidade (HTML Tailwind single-file). - Claude Cowork: cálculo inline com as fórmulas da seção "Cálculo inline", output em markdown. Gere o HTML quando o ambiente permitir rodar o script; caso contrário, entregue a tabela markdown.
Quando usar
Ativa em frases como:
- "ROI de iniciativa de RH", "business case de People"
- "vale a pena o programa de retenção / L&D / wellbeing / onboarding?"
- "payback dessa iniciativa", "justificar investimento em RH", "convencer o CFO"
- "cost benefit de uma ferramenta de recrutamento"
NÃO ativa para: plano de contratação amarrado a crescimento (usar workforce-headcount-plan); custo de uma folha (usar custo-folha-simulator); pacote de remuneração individual (usar total-comp-calculator).
Inputs
--initiative(nome),--type(retention, l&d, recruiting-tool, wellbeing, onboarding, etc.)--cost-onetime(R$),--cost-recurring(R$/ano),--population(headcount afetado)- Uma ou mais linhas de benefício (ao menos uma é obrigatória):
--benefit-attrition "delta_pct=4,headcount=120,cost_per_turnover=120000"--benefit-productivity "pct_gain=3,headcount=120,avg_loaded_cost=180000"--benefit-ttf "days_saved=15,cost_per_vacancy_day=1500,hires_per_year=30"--benefit-custom "Redução de overtime=180000"(pode repetir)
Default sugerido de cost_per_turnover: um múltiplo do salário anual (tipicamente 0,5×–2× para roles operacionais, mais para roles especializados). Sempre torne explícita a premissa.
Cálculo inline (Cowork reproduz sem o script)
- Linhas de benefício (anuais):
- attrition:
(delta_pct/100) × headcount × cost_per_turnover. - produtividade:
(pct_gain/100) × headcount × avg_loaded_cost. - time-to-fill:
days_saved × cost_per_vacancy_day × hires_per_year. - custom: valor anual informado.
- attrition:
- Benefício anual = soma das linhas.
- Custo total ano 1 =
one_time + recurring. - ROI ano 1 =
(benefício_anual − custo_total_ano1) ÷ custo_total_ano1 × 100. - Payback (meses) =
custo_total_ano1 ÷ ((benefício_anual − recurring) ÷ 12). Se o denominador ≤ 0, payback não é calculável. - 3 anos: ano 1 carrega o one-time; anos 2-3 só recurring.
net_acumuladosoma os 3 anos. - Sensibilidade: aplica multiplicador ao benefício anual (Conservador ×0,6 · Esperado ×1,0 · Otimista ×1,3) e recalcula ROI/payback/net 3a.
Template de output markdown (Cowork)
## Business case: <iniciativa>
**ROI (ano 1)**: X% · **Payback**: N meses · **Net 3 anos**: R$ Y
Custo total ano 1: R$ A (one-time R$ B + recorrente R$ C) · benefício anual R$ D
### Linhas de benefício
| Benefício | Premissa | Anual |
|---|---|---|
| Redução de attrition | ... | R$ ... |
| ... | ... | ... |
| **Total** | | **R$ ...** |
### Sensibilidade
| Cenário | Mult. | Benefício/ano | ROI | Payback | Net 3 anos |
|---|---|---|---|---|---|
| Conservador | 0,6x | ... | ... | ... | ... |
| Esperado | 1,0x | ... | ... | ... | ... |
| Otimista | 1,3x | ... | ... | ... | ... |
Workflow
Step 1: Coletar: tipo, custos (one-time + recorrente), população, e ao menos uma linha de benefício com premissas explícitas.
Step 2: Code:
python3 scripts/initiative_roi.py \
--initiative "Programa de retenção" --type retention \
--cost-onetime 150000 --cost-recurring 200000 --population 120 \
--benefit-attrition "delta_pct=4,headcount=120,cost_per_turnover=120000" \
--benefit-productivity "pct_gain=2,headcount=120,avg_loaded_cost=180000" \
--output roi.html
Step 2 (alt): Cowork inline: siga "Cálculo inline" e produza o markdown.
Step 3: Apresentar: lidere com ROI + payback + net 3 anos. Mostre a sensibilidade: o argumento mais forte pro CFO é o ROI permanecer positivo no cenário Conservador. Cite cada premissa abertamente.
Decisões importantes a comunicar
- Premissas dirigem o resultado:
cost_per_turnover,pct_gainedays_savedsão estimativas. Documente a fonte de cada uma e prefira números conservadores. - Custo de turnover costuma incluir recrutamento, onboarding, perda de produtividade e ramp do substituto, não só o recrutamento.
- Payback vs ROI: payback fala de risco/caixa (quão rápido se paga); ROI fala de retorno total. O CFO olha os dois.
- Sensibilidade é o teste de robustez: se o caso só fecha no cenário Otimista, sinalize como frágil.
Branding & lead capture
Footer Powered by Comp + UTMs (HTML e CLI). eam_client.py. 100% local: nenhum custo, benefício ou premissa sai da máquina.
Resources
| File | Purpose |
|---|---|
scripts/initiative_roi.py |
ROI + payback + sensibilidade + HTML + output inline |
eam_client.py |
Lead capture + telemetria |