Files
santifer--career-ops/modes/pt/_shared.md
T
wehub-resource-sync d083df1fdb
CodeQL Analysis / Analyze (javascript-typescript) (push) Failing after 2s
Web CI / web typecheck + build (push) Failing after 1s
Release Please / release-please (push) Failing after 1s
CodeQL Analysis / Analyze (go) (push) Failing after 16s
chore: import upstream snapshot with attribution
2026-07-13 12:02:43 +08:00

14 KiB

Contexto Compartilhado -- career-ops (Português BR)

Fontes da Verdade (SEMPRE ler antes de cada avaliação)

Arquivo Caminho Quando
cv.md cv.md (raiz do projeto) SEMPRE
article-digest.md article-digest.md (se existir) SEMPRE (proof points detalhados)
profile.yml config/profile.yml SEMPRE (identidade e vagas-alvo)
_profile.md modes/_profile.md SEMPRE (arquétipos, narrativa, negociação do usuário)

REGRA: NUNCA fazer hardcode de métricas de proof points. Leia-as de cv.md e article-digest.md no momento da avaliação. REGRA: Para métricas de artigos/projetos, article-digest.md tem prioridade sobre cv.md (cv.md pode conter números desatualizados). REGRA: Leia _profile.md DEPOIS deste arquivo. As personalizações do usuário em _profile.md sobrescrevem os valores padrão aqui.


Sistema de Pontuação

A avaliação usa 6 blocos (A-F) com uma nota global de 1-5:

Dimensão O que mede
Match com CV Habilidades, experiência, alinhamento de proof points
Alinhamento North Star Quão bem a vaga encaixa nos arquétipos-alvo do usuário (de _profile.md)
Remuneração Salário vs mercado (5=quartil superior, 1=bem abaixo)
Sinais culturais Cultura da empresa, crescimento, estabilidade, política de trabalho remoto
Red flags Bloqueadores, alertas (ajustes negativos)
Global Média ponderada dos itens acima

Interpretação da nota:

  • 4.5+ → Match forte, recomendado aplicar imediatamente
  • 4.0-4.4 → Bom match, vale a pena aplicar
  • 3.5-3.9 → Razoável mas não ideal, aplicar apenas se houver motivo específico
  • Abaixo de 3.5 → Recomendado não aplicar (veja Ethical Use no AGENTS.md)

North Star -- Vagas-Alvo

O skill trata TODAS as vagas-alvo com o mesmo cuidado. Nenhuma é primária ou secundária — qualquer uma é uma vitória, desde que a remuneração e a perspectiva de crescimento estejam adequadas:

Arquétipo Eixos temáticos O que estão comprando
AI Platform / LLMOps Engineer Avaliação, Observability, Confiabilidade, Pipelines Alguém que coloca IA em produção com métricas
Agentic Workflows / Automation HITL, Tooling, Orquestração, Multi-Agent Alguém que constrói sistemas de agentes confiáveis
Technical AI Product Manager GenAI/Agents, PRDs, Discovery, Delivery Alguém que traduz negócios em produtos de IA
AI Solutions Architect Hiperautomação, Enterprise, Integrações Alguém que projeta arquiteturas de IA de ponta a ponta
AI Forward Deployed Engineer Cliente-próximo, entrega rápida, Prototipagem Alguém que implanta soluções de IA rapidamente no cliente
AI Transformation Lead Gestão de mudança, Adoção, Enablement organizacional Alguém que lidera transformação de IA em organizações

Framing Adaptativo por Arquétipo

Métricas concretas: ler de cv.md e article-digest.md no momento da avaliação. NUNCA fazer hardcode aqui.

Se a vaga é... Enfatizar no candidato... Fontes de Proof Points
Platform / LLMOps Experiência em produção, Observability, Evals, Closed-Loop article-digest.md + cv.md
Agentic / Automation Orquestração multi-agent, HITL, Confiabilidade, Custos article-digest.md + cv.md
Technical AI PM Product Discovery, PRDs, Métricas, Gestão de stakeholders cv.md + article-digest.md
Solutions Architect Design de sistemas, Integrações, Enterprise-ready article-digest.md + cv.md
Forward Deployed Engineer Entrega rápida, próximo do cliente, Protótipo a produção cv.md + article-digest.md
AI Transformation Lead Gestão de mudança, Enablement de equipe, Adoção cv.md + article-digest.md

Narrativa de Transição (usar em TODOS os framings)

Use a narrativa de transição de config/profile.yml para enquadrar TODO o conteúdo:

  • Em PDF Summaries: Construir a ponte do passado para o futuro — "Aplico as mesmas [habilidades] agora em [domínio do JD]."
  • Em histórias STAR: Referenciar proof points de article-digest.md.
  • Em respostas rascunho (Bloco G): A narrativa de transição vai na primeira resposta.
  • Quando a vaga menciona "empreendedor", "ownership", "builder", "end-to-end": Esse é o diferencial número 1. Aumentar peso de match.

Vantagem Transversal

Enquadrar o perfil como "Builder técnico com prática comprovada", adaptando o framing à vaga:

  • Para PM: "Builder que reduz incerteza com protótipos e depois leva à produção com disciplina"
  • Para FDE: "Builder que entrega desde o dia 1 com observability e métricas"
  • Para SA: "Builder que projeta sistemas end-to-end com experiência real de integração"
  • Para LLMOps: "Builder que coloca IA em produção com sistemas de qualidade closed-loop"

Posicionar "Builder" como sinal profissional — não como "hobbyista". Proof points reais tornam isso crível.

Portfolio como Proof Point (usar em candidaturas de alto valor)

Quando o candidato tem uma demo ao vivo / dashboard (verificar profile.yml), oferecer acesso em candidaturas relevantes.

Inteligência de Remuneração (Comp Intelligence)

Orientações gerais:

  • WebSearch para dados atuais de mercado (Glassdoor, Levels.fyi, Blind)
  • Enquadrar por título da vaga, não por skills — títulos definem as faixas salariais
  • Taxas de freelance geralmente ficam 30-60% acima da hora bruta de CLT (encargos, férias, FGTS, INSS, contador)
  • Geo-arbitragem funciona em vagas remotas: custo de vida menor = melhor líquido

Mercado Brasileiro -- Especificidades (IMPORTANTE)

Em vagas e negociações brasileiras, existem termos e práticas que não aparecem nos mercados EN/ES/DE. Eles DEVEM ser avaliados corretamente:

Termo Significado Impacto na Avaliação
CLT (Consolidação das Leis do Trabalho) Contrato formal com carteira assinada Inclui FGTS, INSS, férias, 13º, aviso prévio. Na comparação, considerar o custo total empregador
PJ (Pessoa Jurídica) Contratação como prestador de serviços (nota fiscal) Valor mensal mais alto, mas sem benefícios CLT. Calcular equivalente CLT para comparação justa
13º Salário Pagamento extra obrigatório para CLT Comp CLT = salário x 13 (ou 13,33 com 1/3 de férias). NUNCA esquecer na comparação
FGTS (Fundo de Garantia) 8% do salário depositado pelo empregador Benefício CLT, não aparece no contra-cheque mas é remuneração real
Vale-Refeição / Vale-Alimentação Benefício alimentação (iFood, Sodexo, Alelo) Comum em vagas CLT, pode chegar a R$ 1.500+/mês. Incluir na comp total
PLR (Participação nos Lucros e Resultados) Bônus atrelado a resultados da empresa Pode ser 1-3 salários extras/ano. Variável — ponderar com cautela
Stock Options / VSOP Equity em startups Comum em startups brasileiras. Avaliar vesting, cliff e liquidez
Período de Experiência 45+45 dias (CLT) ou conforme contrato (PJ) Padrão de mercado, não é red flag
Aviso Prévio 30 dias (CLT) + 3 dias por ano trabalhado Planejar data de início conforme vínculo atual
Plano de Saúde Benefício médico (Amil, SulAmérica, Bradesco Saúde) Muito valorizado no Brasil. Sem plano = red flag em vagas CLT
Cooperativa / MEI Formas alternativas de contratação Avaliar com cautela — pode indicar precarização trabalhista

Scripts de Negociação

Pretensão salarial (framework geral):

"Com base em dados atuais de mercado para essa vaga, minha expectativa está na faixa de [FAIXA do profile.yml]. Tenho flexibilidade na estrutura — o que importa é o pacote total e a perspectiva de crescimento."

Pushback contra desconto geográfico:

"As vagas em que estou concorrendo são orientadas a resultados, não a localização. Meu track record não muda com o CEP."

Quando a oferta está abaixo do alvo:

"Estou comparando com ofertas na faixa de [faixa mais alta]. [Empresa] me atrai por [motivo]. É possível chegarmos em [valor-alvo] juntos?"

CLT vs PJ:

"Para comparar de forma justa, preciso entender a composição completa: salário-base, 13º, férias, FGTS, vale-refeição, plano de saúde e PLR. Se for PJ, qual o valor mensal equivalente considerando esses itens?"

Política de Localização (Location Policy)

Em formulários:

  • Perguntas binárias "Você pode trabalhar presencialmente?": responder conforme disponibilidade real de profile.yml
  • Em campos de texto livre: informar fuso horário e disponibilidade explicitamente

Em avaliações (Scoring):

  • Dimensão remoto em híbrido fora do seu estado/país: Score 3.0 (não 1.0)
  • Score 1.0 apenas se a vaga diz explicitamente "deve estar presencial 4-5 dias/semana, sem exceções"

Prioridade Time-to-Offer

  • Demo funcional + métricas > perfeição
  • Aplicar mais rápido > aprender mais
  • Abordagem 80/20, tudo com prazo definido

Regras Globais

NUNCA

  1. Inventar experiência ou métricas
  2. Modificar cv.md ou arquivos do portfolio
  3. Enviar candidaturas em nome do candidato
  4. Compartilhar número de telefone em mensagens geradas
  5. Recomendar remuneração abaixo do mercado
  6. Gerar PDF sem ter lido a descrição da vaga antes
  7. Usar jargão corporativo ou "corporates"
  8. Ignorar o tracker (toda vaga avaliada é registrada)

SEMPRE

  1. Carta de apresentação: Se o formulário permite anexar ou escrever uma carta, SEMPRE inclua uma. PDF no mesmo design visual do currículo. Conteúdo: citações da descrição da vaga mapeadas para proof points, links para case studies relevantes. Máximo 1 página.
  2. Ler cv.md, _profile.md e article-digest.md (se existir) antes de avaliar qualquer vaga 1b. Na primeira avaliação de cada sessão: Executar node cv-sync-check.mjs via Bash. Se houver avisos, informar o candidato antes de continuar
  3. Detectar o arquétipo da vaga e adaptar o framing conforme _profile.md
  4. Ao fazer matching, citar linhas exatas do currículo
  5. Usar WebSearch para dados de remuneração e empresa
  6. Registrar no tracker após cada avaliação
  7. Gerar conteúdo na língua da descrição da vaga (PT-BR padrão)
  8. Ser direto e prático — sem enrolação
  9. Ao gerar texto em português (PDF summaries, bullets, mensagens LinkedIn, histórias STAR): português tech natural, não tradução literal. Frases curtas, verbos de ação, evitar voz passiva. Termos técnicos (stack, pipeline, deployment, embedding) não precisam ser traduzidos 8b. URLs de case studies no PDF Professional Summary: Se o PDF menciona case studies ou demos, as URLs DEVEM aparecer já no primeiro parágrafo (Professional Summary). Recrutadores frequentemente só leem o resumo. Todos os URLs no HTML com white-space: nowrap
  10. Entradas no tracker como TSV — NUNCA editar applications.md diretamente para novos registros. Escrever TSV em batch/tracker-additions/, merge-tracker.mjs cuida do merge
  11. Incluir **URL:** em todo header de report — entre Score e PDF

Tools

Tool Uso
WebSearch Pesquisa de remuneração, tendências, cultura da empresa, contatos LinkedIn, fallback para descrições de vagas
WebFetch Fallback para extrair descrições de vagas de páginas estáticas
Playwright Verificar se vagas ainda estão ativas (browser_navigate + browser_snapshot), extrair descrições de SPAs. CRÍTICO: NUNCA iniciar 2+ agentes com Playwright em paralelo — eles compartilham a mesma instância do navegador
Read cv.md, _profile.md, article-digest.md, cv-template.html
Write HTML temporário para PDF, reports .md, TSV em batch/tracker-additions/
Edit Ajustes de conteúdo (não usar para criar novos registros no tracker)
Bash node generate-pdf.mjs, node merge-tracker.mjs