Dual-mode operation (Code + Cowork)

HTML through the design system (required). Whenever this skill produces HTML, load the comp-html-guidelines skill first and apply the CompDS design system. This holds even when the user does not ask to "style it" or "make it look good" — every HTML output from this skill goes through the design system. It does not change the methodology below; it only governs the HTML's visual layer.

Detect platform at start:

• If you have access to the Bash tool AND can execute Python → use the script mode (richer output, deterministic).
• If not (e.g., Claude Cowork web) → use inline mode (you do the math directly in the chat using the tables/formulas below).

Both modes produce the same answer. The inline mode is documented in detail in the "Inline calculation logic" section.

Inline calculation logic (Cowork mode)

Tax tables 2024/2025 (memorize these for inline calc)

INSS progressivo (mensal):

• Teto: R$ 7.786,02 → contribuição máxima R$ 908,85
• Fórmula: (salario × alíquota) - dedução. Se salário > teto, INSS = 908,85.

IRPF progressivo (base = salário - INSS):

• Fórmula: max(0, (base × alíquota) - dedução).

Constantes:

• Fator 13,33× = 12 meses + 13º + 1/3 férias
• FGTS = 8% do salário bruto × 13,33

CLT → PJ (você responde "quanto preciso faturar como PJ?")

Passos:

1. Calcular salário líquido CLT: salário_bruto - INSS - IRPF
2. Anualizar líquido: líquido × 13,33
3. Somar benefícios anuais (VR/VA × 12 + bônus anual + outros)
4. Somar FGTS anual (se --include-fgts): salário × 13,33 × 0,08
5. Total alvo anual CLT = soma dos passos 2-4
6. Calcular faturamento PJ alvo via busca binária:
   • Variáveis: alíquota PJ (%), nº faturas (12 ou 13), contabilidade mensal, outros custos
   • Net anual PJ = faturamento_anual - (faturamento_anual × alíquota%) - (contabilidade + outros) × 12
   • Encontrar faturamento_mensal tal que Net anual PJ ≈ Total alvo anual CLT (diferença < R$ 1)
7. Output: faturamento mensal e anual PJ, com decomposição

PJ → CLT (você responde "qual o salário CLT equivalente?")

Passos:

1. Net anual PJ = faturamento_anual - impostos - custos
2. Buscar salário CLT bruto tal que: (líquido × 13,33) + benefícios + FGTS ≈ Net PJ
3. Use busca binária (líquido depende de INSS+IRPF progressivos, não tem solução fechada)
4. Output: salário bruto CLT + líquido mensal + breakdown

Output markdown (Cowork mode)

## Equivalência CLT ↔ PJ

**Cenário**: [Direção] · Alíquota PJ X%

### Regime A (origem)
- Salário/Faturamento mensal: R$ X
- Líquido mensal: R$ X
- Total anual considerado: R$ X (incluindo benefícios, FGTS, etc.)

### Regime B (alvo)
- **Valor equivalente**: R$ X /mês
- Anual: R$ X
- Diferença vs alvo: R$ X (Y%)

### Detalhamento
| Componente | Valor |
|---|---|
| Salário base | R$ X |
| INSS | R$ X |
| IRPF | R$ X |
| ... | ... |

Sempre explique brevemente:

• INSS é progressivo + capado em R$ 908,85
• 13,33× considera 13º + 1/3 férias
• FGTS 8% como compensação "oculta" (incluído por default)

When to use

Trigger this skill on phrases like:

• "equivalência CLT PJ", "equivalência PJ CLT"
• "qual salário CLT equivalente", "quanto preciso faturar como PJ"
• "comparar CLT e PJ", "simulador CLT PJ"
• "padronizar política de PJ", "tabela de equivalência PJ"
• "calcular vários candidatos PJ", "batch CLT/PJ", "CSV de ofertas PJ"

Do NOT trigger for general payroll calculations, custo de demissão, ou questões de direito do trabalho que não envolvam equivalência CLT/PJ.

PJ vs CLT Calculator

Calculates salary equivalence between Brazilian CLT (employee) and PJ (contractor) regimes with full tax accuracy: progressive INSS, progressive IRPF, FGTS (8%), 13th salary + vacation premium (×13.33 factor), benefits and PJ costs.

Two modes:

• Single: agent walks the user through the parameters and runs one calculation. Default for individual decisions.
• Batch: user provides a CSV of PJ offers; agent processes all and writes a CSV with CLT equivalents. Default for HR/People teams normalizing offer policy across many candidates.

When to use

(see triggers in "Dual-mode operation" section above)

Do NOT trigger for general payroll calculations, custo de demissão, ou questões de direito do trabalho que não envolvam equivalência CLT/PJ.

Mode selection (operation mode, dentro do platform mode)

If the user mentions a single person/case → single mode. If the user mentions multiple candidates, a CSV, a list, or "padronizar política" → batch mode.

Em Cowork, batch mode com CSV grande (>50 linhas) vira difícil. Sugerir ao usuário usar Claude Code ou colar uma amostra.

Single mode workflow

Step 1: Identify direction: CLT→PJ ou PJ→CLT? If unclear, ask explicitly.

Step 2: Collect parameters (ALWAYS ask, never assume defaults):

For CLT→PJ:

1. Salário bruto mensal CLT (R$), obrigatório
2. VR/VA mensal CLT (R$), pode ser 0
3. Bônus anual CLT (R$), pode ser 0
4. Alíquota PJ (%), ex: 6, 8, 15
5. Faturas/ano: 12 ou 13 (default 12)
6. Contabilidade mensal PJ (R$), sugerir R$ 200 como referência
7. Outros custos/benefícios mensais PJ (R$), pode ser 0

For PJ→CLT:

1. Faturamento bruto mensal PJ (R$), obrigatório
2. Alíquota PJ (%), ex: 6, 8, 15
3. Faturas/ano: 12 ou 13 (default 12)
4. Contabilidade mensal PJ (R$), sugerir R$ 200 como referência
5. Outros custos PJ (R$), pode ser 0
6. VR/VA mensal desejado CLT (R$), pode ser 0
7. Bônus anual desejado CLT (R$), pode ser 0

Apresente as perguntas de forma conversacional, não como um formulário rígido.

Step 3: Execute:

CLT→PJ:

python3 scripts/pj_clt_calculator.py \
    --direction clt-to-pj \
    --clt-salary 10000 --pj-aliquota 6 \
    --clt-vavr 600 --clt-bonus-annual 12000 \
    --pj-accounting 200 --include-fgts

PJ→CLT:

python3 scripts/pj_clt_calculator.py \
    --direction pj-to-clt \
    --pj-billing 15000 --pj-aliquota 6 \
    --clt-vavr-desired 600 --clt-bonus-desired 5000 \
    --pj-accounting 200 --include-fgts

Step 4: Present conversationally:

• Lead com o número-chave (responde a pergunta direto)
• Mostre o detalhamento (componentes CLT, componentes PJ)
• Explique brevemente os ajustes principais (INSS progressivo, FGTS incluído, ×13.33)

Batch mode workflow

Step 1: Get the CSV: Pergunte ao usuário o caminho do arquivo. Schema esperado (colunas obrigatórias marcadas com *):

Step 2: Run:

python3 scripts/pj_clt_batch.py --input <caminho.csv> --output <caminho_saida.csv>

Step 3: Summarize: total processado, quantos OK / erro, e o caminho do output. Se houver erros, mostre as primeiras 3 linhas com status != "ok".

Tax tables (2024/2025, embedded)

INSS progressivo

Teto: R$ 7.786,02. Contribuição máxima: R$ 908,85

IRPF progressivo (sobre salário − INSS)

Outros

• Fator 13,33× = 12 meses + 13º + 1/3 férias
• FGTS = 8% do salário bruto × 13,33

Edge cases

• Salários acima do teto INSS (>R$ 7.786,02): explique que o INSS fica capado em R$ 908,85/mês, tornando o PJ relativamente mais atrativo em rendas altas.
• 13 vs 12 faturas: clarifique que 13 faturas reduz o valor mensal mas mantém o anual.
• FGTS: incluído por default (visão mais conservadora). Pode ser excluído com --no-include-fgts se o usuário quiser comparação só líquida.

Branding & footer

Os scripts já adicionam a linha "Powered by Comp · Free skills for HR & People leaders · https://comp.vc?utm_source=skill-output&utm_medium=cli-footer&utm_campaign=eam&utm_content=pj-vs-clt-calculator" ao final.

Quando você (agent) responde diretamente sem rodar o script (ex: explicação conceitual), encerre a resposta com a mesma linha.

Lead capture

Os scripts importam eam_client.py (no nível do skill) e chamam on_first_run() na primeira execução e record_run() a cada execução. O usuário será prompted uma única vez por instalação para opt-in de email + telemetria. Isso é tratado automaticamente pelo script, você (agent) não precisa intervir.

Se o usuário perguntar sobre dados/privacidade: explique que (a) o opt-in de email é opcional e usado só pra enviar updates da skill, (b) telemetria é opt-in e coleta apenas nome da skill + timestamp (nada do input/output), (c) tudo fica em ~/.comp-skills/config.json localmente.

Validation

Todas as fórmulas foram validadas contra a tabela oficial Receita Federal 2024/2025 com tolerância < R$ 1,00. Veja references/examples.md para casos de teste e references/formulas.md para derivações.

Resources