Promoção
Sem travessões. Nada que esta skill escreva pode conter um travessão; use uma vírgula, dois pontos ou parênteses. Aplicado por um hook do repositório. Veja
/flagrare:write-docs.
Palavras simples. Em tudo que o usuário ler, use os nomes simples em
<plugin root>/lib/career/GLOSSARY.md("Comportamentos de Sênior", não "linhas da rubrica"; "seu caso por escrito", não "packet"; "o projeto que você lidera", não "iniciativa"). Na primeira vez que um termo aparecer, explique seu significado em poucas palavras e adicione a palavra usada pela empresa entre parênteses quando o usuário a ouvir no trabalho.
Uma promoção é decidida em uma sala onde o usuário não está, a partir de um caso por escrito, por pessoas que em sua maioria não o conhecem, em um calendário definido com meses de antecedência. Esta skill torna esses fatos visíveis cedo: onde o usuário quer chegar e por quê, como a empresa realmente decide, o que a rubrica pede, quem tem conhecimento em primeira mão do seu trabalho e quando as conversas-chave devem acontecer.
Ela escreve um mapa de promoção: promotion-map.md para o usuário ler e levar para um 1:1, e promotion-map.json com os mesmos fatos para as outras skills de carreira. O mapa é local e privado. Esta skill nunca publica, envia ou divulga nada.
Biblioteca
O plugin fornece scripts auxiliares em <plugin root>/lib/career/. A raiz do plugin está dois diretórios acima do diretório base desta skill. Execute cada um como python3 <plugin root>/lib/career/<script>.py .... Eles apenas leem e imprimem JSON; esta skill escreve cada arquivo com a ferramenta Write, pois um shell em sandbox não pode escrever em ~/.claude/skills.
career_state.py paths|contributions|plan --home "$HOME": localizações de arquivos, o registro de contribuições (união de localizações antigas e novas) e o plano de migração.map_schema.py check <map.json> --today YYYY-MM-DD: erros, seções ausentes, seções desatualizadas (mais de 90 dias), conflitos.deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published]: quando falar com o gestor.--deadé opcional e repetível.
A forma do mapa está em reference/map-schema.md, e o layout em markdown está em reference/map-template.md. Os outros arquivos de estado compartilhado (registro de contribuições, flags, iniciativas) são descritos em <plugin root>/lib/career/STATE.md; limpe uma flag tratada escrevendo flags.json de volta sem ela.
1. Carregar estado (a cada execução)
- Execute
career_state.py plan. Aplique cada açãowritecom a ferramenta Write, lendo o destino primeiro se ele já existir (a ferramenta Write não sobrescreverá um arquivo que não leu). Uma açãomkdirnão precisa de etapa separada: a pasta é criada pelo primeiro arquivo escrito nela. Não escreva um mapa placeholder. Nunca delete nada. - Leia
~/.claude/skills/flagrare/config.json(chaves de identidade de alto nível, o blocoskills.promotion) e o mapa existente, se houver. Se o arquivo de configuração ou o blocoskills.promotionestiver faltando, continue com os padrões. - Nenhum mapa significa uma primeira execução (seção 3). Um mapa cuja saída de
map_schema.py checkliste seçõesmissingsignifica uma primeira execução interrompida: retome na fase mais antiga cujas seções estão faltando. Caso contrário, execute uma atualização (seção 4), a menos que o usuário peça o modopacket(seção 5).
Chamado por /flagrare:career. Os argumentos nomeiam um modo (first_run, resume ou refresh) e as seções para trabalhar: faça apenas essas. Quando também disser scheduled, nunca entreviste ou pergunte: pesquise novamente e salve apenas as seções que não precisam de resposta do usuário (processo, calendário, rubrica, organização, precedente), e retorne cada uma que precise do usuário (objetivo, pessoas, perguntas para o gestor) como uma linha para a lista de Necessidades do coordenador. Em ambos os casos, retorne um breve resumo do que mudou em vez do mapa completo.
2. Regras para cada fato
- Fonte, data, status. Cada fato recebe um link ou localização citada, a data em que você o verificou e um status:
verified(lido e citado na fonte bruta),unverified(um resumo, trecho ou informação de segunda mão) ouinferred(seu raciocínio). - Cite verbatim da fonte bruta. Ferramentas de busca resumem e parafraseiam. Quando uma citação for essencial, releia a página bruta (por exemplo, o JSON ou HTML da página) e confirme as palavras exatas.
- Mostre conflitos, nunca escolha silenciosamente. Quando duas fontes discordarem (um organograma vs. um diretório de squad, uma página de processo vs. o arquivo da carreira ladder), armazene ambas como
alternativese informe o usuário. - "Nada encontrado" é um resultado válido. Se uma etapa não encontrar nada, adicione uma pergunta concreta a
manager_questionsem vez de adivinhar. Muitas empresas não têm processo escrito. - Fatos sobre pessoas são sensíveis. Leia apenas as interações do próprio usuário. Registre quem tem contexto de primeira mão sobre o trabalho do usuário, nunca uma classificação de quão úteis as pessoas são.
- Peça consentimento antes de usar o navegador em portais de RH ou sites internos.
3. Primeira execução
Avise o usuário de antemão: a primeira execução é longa, muitas vezes uma hora ou mais, e ela salva após cada fase, então pode ser interrompida e retomada.
Cada salvamento escreve tanto promotion-map.json quanto promotion-map.md, e define sections.<name>.checked_at (hoje) e sections.<name>.sources para cada seção escrita naquela fase. Uma seção sem checked_at é considerada desatualizada. A Fase 1 escreve target, process e calendar; a Fase 2 escreve rubric; a Fase 3 escreve org, people e precedent; a Fase 4 escreve packet_readiness e manager_questions. Escreva cada seção mesmo quando nada for encontrado (uma lista ou objeto vazio com seu checked_at), para que uma seção vazia não seja confundida com uma execução interrompida.
Fase 1: Objetivo, processo e calendário
- Entreviste primeiro, antes de qualquer pesquisa. Faça uma pergunta de cada vez:
- Nível atual e nível desejado.
- Trilha: contribuidor individual ou gestor.
- Para qual ciclo você está mirando (volte a isso após a etapa 4, assim que o calendário for conhecido, e proponha um).
- Por que você quer isso, de qual trabalho você quer mais e de qual você quer menos.
- Pesquise dois fatos sobre o nível desejado: é terminal nesta empresa (sem expectativa de promoção além dele) e qual é a faixa de tempo esperada no nível atual? Cite ambos.
- Diga como o "porquê" muda as coisas. Um objetivo terminal mais um "porquê" de paz de espírito torna o objetivo a linha de chegada. Um "porquê" de dinheiro ou escopo significa planejar além dele. Escreva isso na seção 1 do mapa.
- Encontre o processo, calendário e modelo de packet em toda fonte conectada: wiki, docs, anúncios de chat, notas de reunião, o portal de RH (com consentimento). Também encontre como as decisões de produto são tomadas: o documento de decisão e quem geralmente o conduz. O opportunity-scan precisa disso. Também encontre o que a liderança mede: os temas ou documentos de estratégia da empresa, OKRs e documentos de planejamento, e o que as reuniões de planejamento e all-hands dizem (em notas de reunião como Granola, quando conectado). Registre cada métrica que importa para a área do usuário em
priorities: o tema, a métrica, sua linha de base e meta quando escritos (cada um um fato com uma fonte), o time que a possui euser_lever:ownerse a cadeira do usuário for dona da principal entrada da métrica,inputse seus sistemas a alimentam,nonese a alavanca estiver em outro time. O opportunity-scan classifica propostas contra esta lista. Tire prioridades de notas de reunião, nunca de citações sobre pessoas. - Salve o mapa (JSON e Markdown) com as entradas
target,process,calendaresectionspreenchidas.
Fase 2: Lacuna da rubrica
- Encontre o artefato contra o qual os gestores avaliam (uma planilha de carreira ladder, uma workbook de check-in), não prosa escrita sobre ele. Pergunte ao usuário se seu gestor usa uma workbook de check-in. Se a prosa e o artefato discordarem, use o artefato e registre a incompatibilidade em
rubric.prose_mismatches. - Construa uma entrada
rubric.rowspor comportamento: o texto do nível atual, o texto do nível desejado, um id estável (<area>.<short-slug>) e umlabel, o comportamento em duas a quatro palavras simples ("Encontrar problemas", "Revisor requisitado"), que o quadro e os resumos mostram em vez do id. - Marque cada linha como
done,partialounot_started, com evidências decareer_state.py contributions, reconhecimento que colegas deram ao usuário (quando uma ferramenta de reconhecimento estiver configurada, veja "Reconhecimento" abaixo: cada bônus com seu link é prova, e o valor da empresa ao qual está associado aponta para o comportamento de valores essenciais), as avaliações e trabalho do usuário, e notas de avaliações anteriores que o usuário compartilhar. - Salve.
Fase 3: Organização e quem conhece seu trabalho
- Organização: a cadeia do usuário, quem está acima de cada equipe onde ele pode parar, e mudanças futuras (saídas, novos líderes, reorganizações de notas de reunião e anúncios). Cada pessoa recebe uma fonte e um status.
- Quem conhece seu trabalho, evidências primeiro, depois o usuário:
- Proponha pessoas das próprias interações do usuário (avaliações dadas e recebidas, threads compartilhadas, reuniões compartilhadas e todos que lhe deram reconhecimento), cada uma com links de evidência. Uma pessoa que reconheceu o usuário viu seu trabalho em primeira mão; sinalize qualquer uma que esteja no comitê de promoção.
- Peça ao usuário para confirmar e corrigir, e para adicionar o que nenhuma ferramenta pode ver, como um ex-gestor ou um time de hackathon.
- Defina
seen_your_workeconfirmed_by_user.
- Quem está na calibração: infira a partir do documento de processo, cite a frase e marque como
inferred. Liste as pessoas na sala que não viram o trabalho do usuário. - Precedente: leia anúncios de promoção recentes para ver o que foi creditado e escreva "anúncios são narrativas, não auditorias" no mapa. Ofereça o nível profundo apenas se o usuário pedir: verificação cruzada em código, docs e tickets de quem realmente originou o trabalho. É caro e desligado por padrão.
- Salve.
Fase 4: Plano
- Prazos: execute
deadlines.pycom o prazo do packet. Se a data deste ciclo estiver publicada, use-a e passe--published. Caso contrário, projete a data do ano passado para este ciclo (mesmo mês e dia, um ano depois) e deixe-a comoinferred. Pergunte ao usuário quais feriados ou janelas de férias são períodos mortos onde ele está e passe-os como--dead. Registre "confortável até X, absoluto até Y" com seu status e estado. Se o estado forpast, diga isso claramente e nomeie o próximo ciclo. - Um próximo passo por linha aberta: para cada linha que não está
done, escrevanext_step: a única ação concreta mais barata que adicionaria evidência, adaptada ao que você descobriu sobre a empresa ("digite /interview no canal de recrutamento", "ofereça uma sessão de pareamento no dashboard parceiro", "peça ao seu gestor um pedaço do roadmap para co-liderar"). O quadro lista as três maiores lacunas com esses passos, então faça cada um realizável em uma semana, não um objetivo. - Prontidão do packet: execute
python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date>para a contagem de evidências de cada linha da rubrica (entradas de registro marcadas com a linha mais a evidência da própria linha), depois marque cada seção do template comostrong,thinouemptya partir das linhas que ela utiliza. - Escolhas de feedback de pares: de
recognition.py summary, as pessoas que mais reconheceram o usuário e pelo quê são os primeiros candidatos para o feedback de pares do caso por escrito (3 a 5); adicione-os à nota de Feedback de Pares. - Perguntas para o gestor: tudo ainda desconhecido, mais a pergunta de prontidão (" é realista e o que está faltando?").
- Execute
map_schema.py check. Corrija quaisquer erros, depois salve. - Mostre ao usuário um breve resumo: o objetivo, as duas datas de conversa, os comportamentos de Sênior ainda não demonstrados (pelo label), quem ainda precisa ver seu trabalho e as perguntas para seu gestor. Aponte para
promotion-map.md.
4. Atualização
- Execute
map_schema.py checke leiacareer/flags.jsonse existir (outras skills escrevem sinais de desatualização lá, como uma reorganização, uma saída ou um calendário sendo publicado). Atualize o reconhecimento compython3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>(aplique sua escrita planejada decareer/recognition.jsoncom a ferramenta Write; ela precisa de rede) quando uma ferramenta de reconhecimento estiver configurada. - Pesquise novamente apenas as seções desatualizadas ou sinalizadas. Mantenha todas as outras seções como estão.
- Pergunte ao usuário "algo mudou?", cobrindo objetivo, gestor, equipe e pessoas que viram seu trabalho.
- Se a seção de calendário for verificada novamente, ou uma flag disser que o calendário foi publicado, execute
deadlines.pynovamente e atualizecalendar.manager_conversation. - Atualize o
next_stepde cada linha aberta quando a evidência para ela tiver mudado (um passo que está concluído ou não é mais o mais barato é substituído) e adicione qualquerlabelausente. - Atualize
checked_atpara cada seção verificada novamente, limpe as flags que você tratou e salve.
Reconhecimento
Quando a empresa do usuário usa uma ferramenta de reconhecimento entre pares (atualmente Bonusly), seus agradecimentos são prova de que o usuário não precisou registrar. Configuração: o usuário cria um token de API pessoal na ferramenta e o salva em ~/.config/flagrare/bonusly-token (ou o arquivo nomeado por skills.career.recognition.token_file em config.json). Nunca armazene o token em config.json ou em um repositório, e nunca o cole no chat. Em seguida, execute python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> (aplique sua escrita planejada de career/recognition.json com a ferramenta Write; ela precisa de rede); recognition.py summary fornece totais, valores da empresa e quem mais reconheceu o usuário; agradecimentos de contas automáticas da ferramenta (aniversários, datas comemorativas, boas-vindas) são contados separadamente e nunca tratados como pessoas ou prova. Cite apenas o que é dito sobre o usuário. Nada é nunca enviado através da ferramenta.
5. Modo packet (/flagrare:promotion packet)
Quando o prazo do packet se aproximar, ou o usuário pedir:
- Carregue o mapa; se não houver nenhum, execute a primeira execução primeiro. Reúna evidências desde a data da última promoção (ou a data de contratação): use
/flagrare:brag-docpara janelas de até um mês e/flagrare:impact-timelinepara as mais longas. - Rascunhe o packet no template da empresa, a partir de
process.packet_template(se o template for desconhecido, use esta forma comum e diga que é um fallback: os campos de cabeçalho, depois 2-3 projetos (papel, estimativa...).