andreworia/scenario-manager

Gerenciador de Cenários (Base / Alta / Baixa)

Quando usar

Use quando um modelo precisa alternar de forma limpa entre os casos Base, Alta e Baixa, impulsionados por um pequeno conjunto de premissas, e você deseja que cada caso seja visível e auditável em uma única planilha. Esta skill CONSTRÓI um .xlsx baixável do zero no aplicativo Claude (openpyxl mais validação de dados), com um seletor vivo, puxadas de premissas baseadas em fórmulas, uma tabela de comparação e uma passagem de recálculo e verificação. Não se trata do suplemento Claude for Excel.

O que ela constrói

Cinco áreas: uma aba Capa (seletor e resumo), uma aba Entradas de Cenário (cada direcionador em Base, Alta, Baixa), vínculos ativos no modelo para que as premissas puxem o caso ativo, uma aba de comparação de Saídas (resultados principais lado a lado dos três casos) e uma aba Verificações.

Fluxo de construção

1. Liste os direcionadores que diferem entre os casos (por exemplo, crescimento, preço, churn, capex) e encontre a célula de premissa de cada direcionador no modelo.
2. Construa o bloco Entradas de Cenário mantendo os valores Base, Alta, Baixa para cada direcionador.
3. Construa uma única célula seletora (1, 2 ou 3) com um menu suspenso de validação de dados.
4. Reescreva cada célula de premissa do modelo para puxar o caso ativo via CHOOSE ou INDEX referenciando o seletor.
5. Construa a aba Saídas comparando os principais resultados em todos os três casos (cálculo paralelo, veja especificação), para que todos os casos apareçam ao mesmo tempo, independentemente do seletor.
6. Adicione a aba Verificações.
7. Recalcule a pasta de trabalho em um motor real (LibreOffice headless).
8. Verifique zero erros de fórmula (#REF!, #DIV/0!, #VALOR!, #NOME?), confirme que as verificações passaram e entregue o .xlsx.

Especificação aba por aba

Aba Capa

• B2: célula seletora. Aplique a lista de validação de dados 1,2,3 (ou lista nomeada Base, Alta, Baixa mapeada para 1/2/3).
• B3: nome do caso ativo, =ESCOLHER(B2;"Base";"Alta";"Baixa").
• Um pequeno resumo de resultados que lê a saída do modelo ao vivo sob o caso ativo, por exemplo B6 =Modelo!B40.

Aba Entradas de Cenário

Uma linha por direcionador, uma coluna por caso:

• A nome do direcionador, B Base, C Alta, D Baixa (todas entradas azuis), E valor ativo (fórmula preta).
• Valor ativo puxa com o seletor. Usando ESCOLHER: E5 =ESCOLHER(Capa!$B$2;B5;C5;D5).
• Equivalente com ÍNDICE: E5 =ÍNDICE(B5:D5;Capa!$B$2). ÍNDICE é mais limpo quando o número de casos pode crescer; ESCOLHER é mais explícito para três casos fixos.
• Copie a fórmula escolhida para baixo em cada linha de direcionador para que a coluna seja consistente.

Vínculos com o modelo

• Cada célula de premissa do modelo aponta para o valor ativo, por exemplo Modelo!B6 =EntradasdeCenário!E5.
• Nunca deixe o modelo conter uma premissa digitada que um cenário deveria controlar; o valor deve fluir seletor -> coluna ativa -> modelo.
• Mantenha o vínculo na cor verde de aba cruzada para que revisores vejam que a premissa é impulsionada, não digitada.

Aba Saídas (comparação lado a lado)

Mostre cada caso de uma vez, não apenas o ativo. Dois padrões robustos:

• Cálculo paralelo (preferido para auditabilidade): replique as poucas fórmulas de saída três vezes, cada uma alimentada diretamente pela coluna Base, Alta ou Baixa, em vez da coluna ativa. Por exemplo, VPL sob Alta recalcula a cadeia de saída usando EntradasdeCenário!C5:C12 em vez de E. Isso mostra todos os três sem tocar no seletor.
• Ler-cada: se o modelo for grande, documente que as células de comparação capturam a saída ao vivo para cada caso, ajustando o seletor para 1, 2, 3 durante a etapa de recálculo e colando cada valor capturado; indique claramente quais células são capturas instantâneas versus ao vivo.
• Layout: linhas = métricas principais (Receita, EBIT, VPL, TIR), colunas = Base, Alta, Baixa, mais uma coluna de delta Alta-menos-Base e Baixa-menos-Base.

Aba Verificações

• Seletor dentro do intervalo: =E(Capa!B2>=1;Capa!B2<=3;Capa!B2=INT(Capa!B2)) VERDADEIRO.
• Cada direcionador tem todos os três casos preenchidos: =CONTAR.VAZIO(EntradasdeCenário!B5:D12)=0 VERDADEIRO.
• Coluna ativa corresponde ao seletor: para um direcionador de teste, =(EntradasdeCenário!E5=ESCOLHER(Capa!B2;EntradasdeCenário!B5;EntradasdeCenário!C5;EntradasdeCenário!D5)) VERDADEIRO.

Notas de construção openpyxl

• Adicione o menu suspenso com DataValidation(type="list", formula1='"1,2,3"'), depois ws.add_data_validation(dv) e dv.add(ws["B2"]).
• Escreva cada célula de valor ativo e vínculo como uma string de fórmula, nunca como o número do caso resolvido; o valor só aparece após o recálculo.
• Se usar nomes de casos no menu suspenso, mantenha um mapeamento oculto para que o seletor ainda resolva para um inteiro para ESCOLHER/ÍNDICE; misturar texto e índice em um seletor quebra a fórmula.
• Preencha a célula seletora com um fundo distinto e uma borda grossa para que revisores vejam imediatamente a célula de controle única.

Sanidade direcional

• Alta não deve produzir uma saída pior que Base na métrica principal, e Baixa não deve superar Base; se isso acontecer, os valores do caso de um direcionador provavelmente estão trocados entre as colunas.
• Adicione uma verificação informal opcional na aba Saídas comparando o sinal de cada delta com a direção esperada, para que uma coluna trocada seja detectada no recálculo em vez de na revisão.

Convenções de fórmula e formatação

• Fonte azul para os valores de entrada Base/Alta/Baixa e a célula seletora.
• Fonte preta para fórmulas dentro da aba (a coluna ESCOLHER/ÍNDICE de valor ativo, cálculos de saída).
• Fonte verde para vínculos entre abas, como =EntradasdeCenário!E5 dentro do modelo.
• Sem valores fixos onde uma fórmula cabe: a coluna ativa e as premissas do modelo são sempre fórmulas, nunca o valor do caso redigitado.
• Uma fórmula consistente por linha ou coluna: o mesmo padrão ESCOLHER/ÍNDICE descendo a coluna ativa; a mesma fórmula de saída nas colunas de comparação.
• Formatos de número: taxas 0,0%, moeda #.##0, múltiplos 0,00x. Destaque a célula seletora com um preenchimento para que seja óbvio onde alternar.

Compensação vs. Gerenciador de Cenários integrado

O Gerenciador de Cenários integrado do Excel armazena valores de caso dentro de um diálogo, invisível na planilha, sobrescreve as entradas ao vivo quando exibido e é fácil de dessincronizar do modelo. Um bloco alternador visível mantém todos os casos na grade, torna a puxada ativa uma fórmula rastreável e permite que revisores vejam todos os três resultados lado a lado sem abrir nenhum menu. É mais auditável e sobrevive a cópia, revisão e controle de versão.

Verificações

Veja a aba Verificações acima: seletor em 1..3 e inteiro, nenhuma célula de caso em branco, valor ativo igual ao caso do seletor. Todos os três devem retornar VERDADEIRO.

Recalcular e verificar

Salve com openpyxl, recalcule headless (por exemplo libreoffice --headless --convert-to xlsx) para que ESCOLHER/ÍNDICE e vínculos entre planilhas sejam resolvidos. Recarregue, escaneie por #REF!, #DIV/0!, #VALOR!, #NOME?. Alterne o seletor para 1, 2 e 3 e confirme que as saídas mudam e a verificação ativa se mantém em cada configuração. Corrija e repita até estar limpo, depois entregue.

Entradas a coletar

• Caminho para o modelo e o endereço da célula de premissa para cada direcionador.
• Valores Base, Alta e Baixa para cada direcionador.
• As métricas de saída principais a comparar e suas células.
• Se a comparação deve ser de cálculo paralelo (ao vivo) ou capturas instantâneas.

Exemplo

Direcionadores hipotéticos: crescimento da receita (Base 4%, Alta 8%, Baixa 1%), margem bruta (Base 55%, Alta 58%, Baixa 50%). Seletor Capa!B2 = 2 seleciona Alta, então EntradasdeCenário!E5 =ESCOLHER(2;4%;8%;1%) = 8% flui para Modelo!B6. A aba Saídas mostra VPL de (por exemplo) 760 Base, 1.140 Alta, 410 Baixa em unidades hipotéticas, com um delta Alta-menos-Base de 380, todos visíveis de uma só vez.