total-comp-calculator

name

total-comp-calculator

description

Calculadora de Total Compensation (modelo Comp). Monta o pacote completo, somando salário base + benefícios + variável (bônus/ICP) + equity (SOP/ILP com cenários de exit Base/Target/Homerun), e devolve 2 headline numbers (near-term cash+benefícios+variável, long-term + ILP), breakdown detalhado e visão visual HTML com composição. Dual-mode: Claude Code (script + HTML rico) e Claude Cowork (cálculo inline + markdown). Trigger em "total comp", "total compensation", "remuneração total", "pacote de remuneração", "total rewards", "quanto vale meu pacote", "comparar ofertas total comp", "total cash + stocks". Mantida pela Comp.

Total Compensation Calculator

HTML pelo design system (obrigatório). Sempre que este skill for produzir HTML, carregue antes o skill comp-html-guidelines e 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.

Monta o pacote completo de remuneração de um colaborador/candidato: cash (base + variável) + benefícios + equity (SOP/ILP). Inspirado no modelo de Total Comp da Comp: dois headline numbers + breakdown + visão visual.

Dual-mode operation (Code + Cowork)

• Claude Code: python3 scripts/total_comp.py ... --output tc.html (HTML visual com composição + tabelas).
• Claude Cowork: cálculo inline com as fórmulas abaixo, output em markdown.

Quando usar

Ativa em frases como:

• "total comp", "total compensation", "remuneração total"
• "pacote de remuneração", "total rewards"
• "quanto vale meu pacote / a oferta"
• "comparar ofertas em total comp"
• "total cash + stocks"

NÃO ativa para: só equivalência CLT/PJ (usar pj-vs-clt-calculator); só stock options (usar stock-options-calculator); custo empregador da folha (usar custo-folha-simulator).

Modelo (estrutura fixa)

Componentes

1. Cash:
   • Salário base mensal × 13,33 (12 + 13º + 1/3 férias) = base anual
   • Variável/bônus: como nº de salários, % do base anual, ou valor absoluto
   • Total Cash anual = base anual + bônus
2. Benefícios: itens mensais (VR/VA, plano saúde, etc.) × 12 = anual
3. SOP / ILP (equity):
   • Inputs: nº ações, strike (USD), pps (USD), vesting (anos), cliff, FX
   • Valor gross hoje = ações × pps (USD)
   • Cenários de exit (Base 5× / Target 10× / Homerun 30×):
     • Total R$ = ações × pps × multiplier × FX (ou líquido de strike se --sop-net-of-strike)
     • Anual R$ = Total ÷ anos de vesting
     • Total Cash + Stocks/ano = Total Cash anual + Anual do cenário

Dois headline numbers

• Near-term = base anual + benefícios anual + variável
• Long-term = base anual + benefícios anual + ICP (variável) + ILP (cenário Target anualizado)

Workflow

Step 1: Coletar:

• Salário base mensal (obrigatório)
• Variável: nº salários OU % OU absoluto (opcional)
• Benefícios: lista nome + valor mensal (opcional)
• SOP (se houver): ações, strike, pps, vesting, cliff, FX (opcional)

Step 2: Code:

python3 scripts/total_comp.py \
    --base-mensal 12900 --meses 13.33 \
    --bonus-salarios 2.5 \
    --beneficios "Ticket:1356,Plano de Saúde:635" \
    --sop-shares 1500 --sop-strike 1.12 --sop-pps 4.15 \
    --sop-vesting 4 --sop-cliff 1 --fx 5.20 \
    --cenarios "Base:5,Target:10,Homerun:30" \
    --output total-comp.html

Step 2 (alt): Cowork inline: calcule seguindo as fórmulas acima e produza markdown:

## Total Compensation

**TOTAL COMP (long-term)**: R$ X/ano (base + benefícios + ICP + ILP)
**TOTAL COMP (near-term)**: R$ X/ano (base + benefícios + variável)

### Cash
| Componente | Valor |
|---|---|
| Salário base mensal | R$ X |
| Salário base anual (×13,33) | R$ X |
| Bônus anual | R$ X |
| **Total Cash anual** | **R$ X** |

### Benefícios (mensal)
| Item | Valor |
|---|---|
| Ticket | R$ X |
| ... | ... |
| Sub-total | R$ X (anual R$ Y) |

### SOP / ILP: cenários de exit
| Cenário | Múlt | Total R$ | Anual R$ | Cash + Stocks/ano |
|---|---|---|---|---|
| Base | 5x | R$ X | R$ X | R$ X |
| Target | 10x | R$ X | R$ X | R$ X |
| Homerun | 30x | R$ X | R$ X | R$ X |

Step 3: Apresentar: lidere com os 2 headlines. Explique que long-term inclui o equity no cenário target (não garantido). Mostre composição (% de cada componente).

Decisões importantes a comunicar

• 13,33× captura 13º + 1/3 férias. Não use 12 simples no Brasil.
• Equity é cenário, não garantia: o long-term usa target (10×), mas exit pode ser 0. Sempre contextualize.
• Gross vs net de strike: default é gross (modelo de referência). Use --sop-net-of-strike pra deduzir o custo de exercício (mais conservador).
• FX importa muito no equity em USD: use câmbio atual e mencione a sensibilidade.

Branding & lead capture

Footer Powered by Comp + UTMs (HTML e CLI). eam_client.py. 100% local.

Resources

File	Purpose
scripts/total_comp.py	Calculadora + HTML visual + output inline
eam_client.py	Lead capture + telemetria