Uma Claude Skill que transforma a realidade bagunçada dos dados de pipeline em uma narrativa de forecast de uma página para a chamada semanal de forecast. O output é o documento que o VP de Vendas / CRO lê nos trinta minutos antes da chamada ao vivo: um número headline com uma banda de confiança, os três principais negócios que movem o número, o maior risco único e um pedido para a liderança.
A Skill lê o Salesforce como fonte de verdade sobre o estado do pipeline e o Gong como verificação do que os reps dizem versus o que os clientes realmente disseram. Ela combate dois modos de falha específicos que as equipes de RevOps enfrentam toda semana: negócios em commit por esperança em vez de evidência, e briefings executivos escritos em linguagem tão hedgeada que o exec para de ler.
Quando usar
Use a Skill em cadência recorrente — uma vez por semana por segmento de forecast, postado no canal Slack de forecast cerca de trinta minutos antes da chamada ao vivo. O ponto é dar aos líderes tempo para lê-lo a frio, entrar com perguntas mais precisas e encurtar a chamada.
Vale a pena quando:
- Seus segmentos de forecast têm pelo menos dez negócios de commit ativos por semana. Abaixo disso, o valor marginal sobre um brief escrito manualmente diminui.
- Seus reps registram chamadas no Gong de forma confiável. Se a atividade no Gong for irregular, a seção de risco da Skill vira ruído.
- A disciplina de estágio e data de fechamento no Salesforce é razoável. A Skill não conserta dados ruins; ela os surfacea de forma mais visível, o que é útil mas não é o que a maioria das equipes quer de uma “ferramenta de forecast.”
Quando NÃO usar
Três situações onde o output da Skill é o artefato errado:
- Materiais para conselho de administração sem revisão do CFO. A narrativa é um artefato interno de RevOps reconciliado com o Salesforce, não com o razão de bookings do financeiro. Números mostrados ao conselho devem passar pelo financeiro sob a política de controles. A Skill recusa explicitamente produzir output formatado para o conselho.
- Comunicações vinculadas a divulgações financeiras (10-Q, 10-K, prep de earnings, atualizações para investidores, orientações públicas, qualquer coisa que o jurídico vai ver). Use o processo do financeiro; não cole esta narrativa em nada arquivado externamente.
- Rebasear o commit oficial. Esta narrativa explica o commit que o líder do segmento já definiu. Ela não substitui a reunião de definição de commit em si. Se você se encontrar usando a Skill para descobrir qual deveria ser o commit, você tem dois problemas e esta Skill não está resolvendo nenhum deles.
Configuração
O bundle está em apps/web/public/artifacts/forecast-narrative-skill/. Ele contém:
SKILL.md— instale em~/.claude/skills/forecast-narrative/SKILL.md. DefinaSFDC_TOKEN,GONG_API_KEYno seu ambiente.references/1-narrative-structure.md— o template de seção e as regras por seção. Edite os nomes dos cabeçalhos se o seu exec procura por rótulos diferentes, mas mantenha a contagem de seções: cada seção existe porque sua remoção causou confusão em chamadas anteriores.references/2-hedge-words-blocklist.md— o input para o passo de remoção de hedges. Edite por tom de empresa; amplie sempre que uma palavra hedge sobreviver a uma execução real. A blocklist é o artefato durável — o prompt não é.references/3-sample-output.md— um exemplo trabalhado com o checklist do revisor. Execute uma invocação da Skill em um segmento conhecido primeiro e compare com este; se a estrutura não corresponder, corrija o prompt antes de enviar ao exec.
Configure seus segmentos de forecast em references/segment-config.md — uma linha por segmento com o ID do relatório do Salesforce, o ID do workspace do Gong e o nome do líder do segmento (para que a linha “Pedido ao VP/CRO” seja resolvida automaticamente). Os snapshots ficam em snapshots/<segmento>/<semana_final>.json e são verificados por versão em cada execução; se a contagem de linhas do arquivo não corresponder à contagem esperada do relatório, a Skill aborta antes de calcular deltas.
Invoque cada semana com o slug do segmento e a data de encerramento da semana: build_forecast_narrative(segment="enterprise-amer", week_ending="2026-05-01").
O que a Skill realmente faz
Seis passos, executados em ordem. Eles são sequenciais por design — cada passo após o primeiro depende do snapshot, e o passo de remoção de hedges depende da existência do rascunho completo.
- Snapshot do Salesforce no corte. Extrai o relatório salvo no timestamp de encerramento da semana. Persiste em disco para que a próxima execução tenha um snapshot real da semana anterior para comparar. Comparar contra o estado ao vivo do Salesforce em vez de um snapshot armazenado perde a trilha de auditoria.
- Calcula os deltas. Surfacea cada oportunidade que mudou de categoria de forecast, escorregou data de fechamento em mais de 14 dias, mudou valor em mais de 10%, ou foi criada ou removida do segmento.
- Extrai evidências do Gong por negócio de commit. Para cada negócio em commit, consulta o Gong para atividade do lado do cliente nos últimos 14 dias. Esta é a parte que diferencia a Skill de “resumir Salesforce em Markdown bonito” — combinar os dois sistemas flagra negócios mantidos em commit por esperança, o que o Salesforce sozinho não consegue ver.
- Classifica os movimentadores. Pontua por
abs(amount_change) × close_date_proximity. Pega os três primeiros. Limite rígido em três porque a narrativa é para o exec, não para inspeção. - Identifica o maior risco único. Do conjunto de commits, escolhe um negócio onde o Gong está silencioso por quatorze ou mais dias, a data de fechamento escorregou duas vezes em 60 dias, ou o negócio foi adicionado ao commit nos últimos 7 dias sem uma chamada correspondente com o cliente. Escolhe um. Uma lista de cinco riscos é lida como nenhum risco.
- Passo de remoção de hedges. Gera o rascunho seguindo
references/1-narrative-structure.md. Em seguida, executa um segundo passo que varre contrareferences/2-hedge-words-blocklist.mde reescreve cada formulação sinalizada em uma afirmação direta ou uma admissão de “não saber.” O motivo de dois passos em vez de um prompt direto: modelos de linguagem derivam para hedging quanto mais longo fica o output, e um passo de remoção dedicado captura de forma confiável o que um prompt de passo único perde.
A escolha de usar um formato de narrativa estruturada — ordem de seção fixa, cabeçalhos fixos, forma de raciocínio fixa — em vez de prosa livre é deliberada. O output livre deriva em estrutura semana a semana, o que força o exec a se reorientar em cada leitura. Estrutura fixa significa que o exec varre os mesmos cinco locais toda semana e chega aos mesmos tipos de informação nos mesmos lugares. A previsibilidade é o feature.
Realidade de custos
Uma única narrativa de segmento consome aproximadamente 18.000-24.000 tokens de input (o snapshot, o snapshot anterior, as linhas de atividade do Gong, os três arquivos de referência) e produz cerca de 1.200-1.800 tokens de output, incluindo o passo de remoção de hedges. Com o preço de lista do Sonnet 4.6, isso é da ordem de US$0,07-0,11 por narrativa. Com Opus 4.7, espere US$0,35-0,55. Execute no Sonnet para a cadência semanal e reserve Opus para o final do trimestre quando os stakes justificam o gasto.
Tempo economizado em relação a um brief escrito manualmente: um analista sênior de RevOps leva 60-90 minutos por segmento por semana para montar o mesmo artefato a partir de relatórios brutos do Salesforce e notas do Gong. Em quatro segmentos, isso é aproximadamente meio dia por semana recuperado. A Skill leva 90-120 segundos por segmento para executar, mais 5-10 minutos de revisão humana antes de postar no Slack.
A restrição honesta: o tempo economizado desaparece completamente se o passo de revisão humana for pulado. Os revisores detectam as especificidades alucinadas que esta Skill não pode eliminar; sem esse passo, a realidade de custos se inverte e a Skill se torna um passivo. Orce o tempo de revisão explicitamente.
Métrica de sucesso
Observe um número: duração da chamada de forecast em uma janela de seis semanas consecutivas. Se o brief estiver fazendo seu trabalho, os líderes entram já tendo lido e a chamada encurta em 15-25%. A narrativa substitui a parte “o que mudou esta semana” da chamada, que é a parte que escala pior com volume de negócios.
Métricas secundárias que valem a pena rastrear após o primeiro mês:
- Acurácia de beat-or-miss do headline contra os resultados no fechamento do período (meta: dentro de US$500K em segmentos acima de US$10M de commit).
- Número de correções “isso está errado” dos líderes de segmento por semana (meta: tendendo a zero até a semana seis).
- Se o negócio de “maior risco único” realmente escorregou — falsos positivos são toleráveis, mas um padrão de falsos negativos (negócios que escorregaram e não foram sinalizados) significa que as heurísticas de risco no passo 5 da Skill precisam de ajuste.
vs alternativas
- Clari Narrative. O Clari produz um artefato semelhante nativamente se você já está no Clari. A Skill ganha quando (a) você não está no Clari e sua ferramenta de forecast de registro é Salesforce + Gong + planilhas, ou (b) você está no Clari mas quer estender a narrativa com raciocínio específico da empresa que o template do Clari não consegue expressar. Clari ganha em deploy out-of-the-box e em hooks mais estreitos com o Salesforce.
- Gong Forecast Notes. As features de forecast do Gong dependem muito do sinal do lado das chamadas e são mais fracas no raciocínio de estado de pipeline. A Skill costura explicitamente o estado do lado do Salesforce com evidências do lado do Gong; o Gong Forecast Notes faz o oposto e trata o pipeline como algo secundário. Escolha esta Skill quando o Salesforce é a fonte de verdade e o Gong é a camada de verificação.
- Brief executivo escrito manualmente. Um analista sênior de RevOps ainda produz a melhor narrativa — a Skill está na melhor das hipóteses em 80% desse output, e esse 80% é sobre estrutura factual, não sobre julgamentos de quais negócios surfacear. A Skill ganha em consistência, cadência e o meio dia por semana que devolve ao analista. O analista deve revisar e editar cada execução; esta é uma ferramenta de co-autoria, não uma substituição.
Pontos de atenção
- Alucinações confiantes sobre especificidades de negócios. O modelo pode inventar um passo de procurement, nome de stakeholder ou valor de contrato que soa plausível. Proteção: cada afirmação sobre um negócio específico deve ser rastreada a um campo do Salesforce ou a um resumo de chamada do Gong nos dados de origem. A Skill rotula qualquer afirmação inferida-não-observada com
(inferido)ou a omite. Se uma afirmação específica confiante aparecer sem citação de fonte, trate a execução como falha e re-execute com um conjunto menor de negócios. - Linguagem de hedging voltando apesar do passo de remoção. “Pode,” “poderia,” “potencialmente,” “parece que” voltam, especialmente na seção de risco. Proteção: estenda
references/2-hedge-words-blocklist.mdsempre que uma nova palavra hedge sobreviver a um passo. A blocklist é o artefato durável; o prompt não é. RevOps é dono deste arquivo. - O resumo citado como o forecast real. A narrativa explica o commit; ela não o define. Proteção: o headline cita o número de commit do líder do segmento, nunca um número calculado pela Skill sozinha. Se
current_commitnão foi passado, a Skill rotula seu intervalo calculado como “intervalo de cobertura de pipeline calculado pela Skill, não um commit aprovado” para que o documento não possa ser mal interpretado como o número oficial. - Drift de snapshot. Se
snapshots/<segmento>/<semana_final>.jsonfoi escrito a partir de um relatório parcialmente carregado (timeout do Salesforce no meio do pull, por exemplo), os deltas na próxima execução estarão errados de formas invisíveis. Proteção: a primeira linha do arquivo de snapshot registra a contagem de linhas esperada vs recebida; se discordarem, a Skill aborta e diz ao operador para re-fazer o snapshot antes de continuar. - Disciplina de estágio. Se reps movem negócios para commit sem o trabalho ser feito, nenhuma Skill conserta isso. A narrativa reportará fielmente o que o Salesforce diz. Combine esta Skill com um workflow de validação de progressão de estágio upstream.
Stack
- Salesforce — estado do pipeline, histórico de estágio, valores de negócios, o relatório salvo que define cada segmento.
- Gong — sinal de atividade do lado do cliente e resumos de chamadas usados como verificação da narrativa do rep.
- Claude — síntese de narrativa, classificação e o passo de remoção de hedges. Sonnet para cadência semanal; Opus para final de trimestre quando os stakes justificam.