gaas-growth-context
Preparar o Growth Context Pack para reports Afinz/GaaS, Report Live, CRM aquisicao, midia paga, seguros, Plurix/B2B2C, contratos de views/slides, perfis de output semanal/mensal/deep dive, storytellin
SKILL.md.claude/skills/gaas-growth-context/SKILL.md
GitHubGaaS Growth Context
Objetivo
Gerar um Growth Context Pack antes de qualquer report Afinz/GaaS. A skill nao substitui SQL, planilha, Supabase ou Report Live: ela organiza contexto, contrato de views, perfis de output, guardrails, narrativa e textos permitidos para que o report nao vire uma colecao solta de tabelas.
Regra central: numeros vem de Supabase/SQL/views; a LLM escreve apenas prosa, diagnostico, recomendacao e limites de leitura.
Workflow
- Definir ou inferir o
report_profileantes de selecionar slides. - Ler os invariantes de Report Live em
references/report-live-invariants.md. - Ler
references/output-profiles.mdpara configurar janela, comparacao, profundidade e blocos. - Ler
references/growth-slide-view-contract.mdquando precisar mapear slides, tabelas, colunas ou ordem tecnica. - Ler
references/storytelling-growth.mdquando precisar escrever narrativa ou ordenar a apresentacao. - Ler
references/metric-dictionary.mdantes de interpretar KPI, delta, CAC, CPA, CPL, funil ou pacing. - Ler
references/supabase-source-map.mdantes de consultar ou especificar fontes vivas. - Ler
references/data-quality-guardrails.mdantes de concluir, recomendar escala, bloquear leitura ou classificar confianca. - Ler
references/asset-patterns.mdquando a tarefa envolver PPTX/PDF/XLSX, deck, planilha-mestre ou layout de slides. - Ler
references/ai-analytics-benchmarks.mdquando precisar contrapor a arquitetura com referencias externas de semantic layer, agentic analytics ou data storytelling. - Ler
references/output-contract.mdpara produzir o Growth Context Pack,TEXT_REGISTRY_FOR_SKIP_LLMou action queues.
Report Profile
Nunca assumir que o output e mensal. Todo trabalho deve declarar um perfil:
report_profile:
output_type: weekly_impact_cutoff
audience: lideranca_operacional
analysis_window: current_week_monday_to_latest_closed_day
comparison_window: previous_week_same_weekdays
context_window: month_to_date_until_latest_closed_day
data_cutoff_rule: latest_closed_day_available
narrative_mode: acompanhamento_growth
depth: standard
Se o usuario pedir "sexta com dados ate quarta", usar:
- janela analisada: segunda ate o ultimo dia fechado disponivel;
- comparacao principal: mesmos dias da semana anterior;
- contexto auxiliar: mes acumulado ate o mesmo corte;
- proibicao: nao comparar semana parcial com semana cheia como conclusao principal.
Saida Padrao
Produzir, conforme a tarefa pedir:
GROWTH_CONTEXT_PACK.mdVIEW_CONTRACT_NORMALIZED.tsvou JSON equivalenteNARRATIVE_PLAN.mdTEXT_REGISTRY_FOR_SKIP_LLM.jsonACTION_QUEUE_SCHEMA.tsvDATA_QUALITY_NOTES.md
Se for uma resposta em chat, manter a mesma estrutura em texto, sem inventar numeros.
Scripts
Use scripts/normalize_view_contract.py para transformar uma TSV de views/slides em JSON ou TSV normalizada.
Use scripts/scan_growth_context.py para inventariar arquivos relevantes no repo/vault antes de montar um pack novo.
Quando a tarefa exigir dado vivo, usar a skill/ferramenta de Supabase disponivel no ambiente. Os scripts desta skill nao devem embutir credenciais nem substituir consultas governadas.
Guardrails Fixos
- Nao escrever numero que nao venha de dados.
- Nao tratar delta como obrigacao de dizer melhorou ou piorou; delta e campo auxiliar.
- Nao tratar CPA de plataforma como CAC.
- Nao inferir cartao, receita ou CAC de rentabilizacao por clique.
- Nao comparar janelas parciais com janelas cheias como conclusao principal.
- Nao misturar Plurix/B2B2C como bloco externo quando o pedido for Aquisicao CRM; tratar como parte da inteligencia de aquisicao.
- Resumir seguros como inteligencia conectada a CRM e midia, salvo pedido explicito de deep dive.
- Diferenciar evidencias confirmadas, direcionais, suspeitas e bloqueadas.
- Para Report Live, respeitar
skip_llm: textos entram prontos; dados e graficos vem das views. - Para publicacao Report Live, preparar payload compativel com
report-sync,skip_llm:true, pg_net e validacao posterior emreport_runs.