sinapse-ai 9.2.0 → 9.4.0

package/squads/squad-product/knowledge-base/brazilian-product-context.md

@@ -0,0 +1,284 @@
+# Brazilian Product Context
+
+## Purpose
+Contexto especifico do mercado brasileiro que impacta decisoes de produto — pagamentos, comportamento, regulacao, canais e ecossistema digital. Produto construido sem considerar contexto BR tem chance de falhar mesmo com excelente execution.
+
+## Numeros do Mercado Digital Brasileiro (2025-2026)
+
+| Metrica | Valor | Fonte |
+|---------|-------|-------|
+| Populacao online | ~183 milhoes | DataReportal Jan 2025 |
+| Penetracao internet | ~86.2% | DataReportal Jan 2025 |
+| Smartphones ativos | ~170 milhoes | GSMA |
+| Tempo medio online/dia | ~9h30 | DataReportal — top 5 mundial |
+| E-commerce GMV | ~R$ 200 bilhoes/ano | ABComm 2025 |
+| Usuarios ativos em social media | ~144 milhoes | DataReportal Jan 2025 |
+| Penetracao WhatsApp | ~99% dos brasileiros online | Meta / analises independentes |
+
+## PIX — O Motor de Conversao Brasileiro
+
+O PIX, lancado pelo Banco Central em novembro de 2020, e o sistema de pagamento instantaneo mais bem-sucedido do mundo por velocidade de adocao. Para produto, PIX e obrigatorio — nao opcional.
+
+### Impacto em Conversao
+
+| Metrica | Impacto | Contexto |
+|---------|---------|---------|
+| Abandono de checkout | -30-40% vs. boleto | Pagamento instantaneo elimina fricao |
+| Conversao | +15-25% vs. boleto | Boleto tinha alta taxa de desistencia (gerar ≠ pagar) |
+| Custo para merchant | ~0% | Cartao de credito: 2-5% de taxa |
+| Tempo de liquidacao | Instantaneo | Boleto: 1-3 dias. Credito: 30 dias |
+| Inclusao financeira | Alto | 60M+ brasileiros sem cartao de credito agora podem pagar online |
+
+**Regra de produto:** Qualquer produto com pagamento no Brasil que nao oferece PIX esta perdendo conversao de forma desnecessaria. Implementar PIX e sempre prioridade.
+
+### PIX no Produto
+
+**Casos de uso alem do e-commerce:**
+- **PIX Cobranca** — Gera QR code com valor e vencimento (substitui boleto)
+- **PIX automatico (Debito Automatico)** — Para cobrancas recorrentes (subscription SaaS)
+- **PIX Parcelado (2025+)** — Parcelamento no PIX sem cartao de credito
+- **PIX Internacional (2025-2026)** — Integracoes com Wise, transfers internacionais via PIX
+
+**Para SaaS brasileiro:** Modelo freemium funciona melhor quando o upgrade via PIX e tao facil quanto a experiencia free. Friction no pagamento = conversao perdida.
+
+### Gateways de Pagamento (Stack Recomendado)
+
+| Gateway | Foco | PIX | Recorrencia | Notas |
+|---------|------|-----|-------------|-------|
+| **Stripe (com Pagar.me)** | International SaaS | Sim | Sim | Stripe agora com suporte nativo ao BR |
+| **Pagar.me (Stone)** | Brasil-first | Sim | Sim | Melhor integracao com ecossistema BR |
+| **Iugu** | SaaS brasileiro | Sim | Sim | Focado em recorrencia |
+| **PagSeguro** | SMB brasileiro | Sim | Basico | Mais simples, menos features |
+| **Asaas** | SMB recorrente | Sim | Excelente | Cobrana automatica com PIX |
+| **Vindi** | Enterprise recorrente | Sim | Excelente | Maior enterprise da categoria |
+
+## WhatsApp-First UX
+
+O Brasil e o mercado onde WhatsApp substituiu praticamente todos os outros canais de comunicacao. Para produto, isso muda a UX fundamentalmente.
+
+### Dados de Uso
+
+- 99% de penetracao entre usuarios de internet
+- Canal #1 de comunicacao pessoal E profissional
+- Usado para: atendimento ao cliente, vendas, suporte, notifications, community
+- Grupos de WhatsApp substituem email em muitos contextos empresariais
+
+### Implicacoes para Produto
+
+**Onboarding via WhatsApp:**
+- Usuarios esperam poder se cadastrar ou verificar conta via WhatsApp OTP
+- WhatsApp Business API permite envio de mensagens programaticas para onboarding
+- Alternativa ao email marketing com open rates muito maiores (WhatsApp: ~90% vs email: ~20-25%)
+
+**Notificacoes:**
+- Push notifications tem taxa de permissao baixa no Brasil (~40-50%)
+- WhatsApp notifications tem taxa de leitura e resposta significativamente maior
+- Ferramentas: Zenvia, Twilio (WhatsApp Business API), WATI, Take Blip
+
+**Suporte:**
+- Usuarios brasileiros esperam suporte via WhatsApp, nao apenas email
+- Chat ao vivo via WhatsApp e considerado standard em produtos B2C e SMB
+- Chatbots no WhatsApp sao cada vez mais aceitos para tier-1 support
+
+**Compartilhamento e Viralidade:**
+- "Compartilhar no WhatsApp" e o botao de sharing mais efetivo no Brasil
+- Grupos de WhatsApp sao communities naturais para growth organico
+- Conteudo viral no Brasil geralmente comeca em grupos de WhatsApp
+
+### UX Patterns Brasileiros
+
+```
+Patterns que funcionam no Brasil:
+
+1. Login por CPF + SMS (nao apenas email)
+   → Brasileiros sao mais confortaveis com CPF que username
+   
+2. WhatsApp login/verification
+   → Mais fricao que Google/Facebook mas mais confiavel para usuarios 40+
+   
+3. Parcelamento visivel
+   → "12x de R$49 sem juros" e mais persuasivo que "R$588/ano"
+   → Mesmo em SaaS: oferecer anual parcelado aumenta conversao
+
+4. PIX QR Code + Pix Copia e Cola
+   → Ambos obrigatorios — alguns bancos tem problema com QR, outros com copiar
+
+5. "Gratuito por X dias" vs "Trial"
+   → "Gratuito" converte melhor que "trial" no vocabulario brasileiro
+
+6. Suporte humano proximo
+   → Botao de WhatsApp visivel em todas as telas reduz ansiedade de compra
+   → Usuarios brasileiros valorizam "tem alguem para me ajudar?"
+```
+
+## LGPD — Impacto Direto em Produto
+
+A Lei Geral de Protecao de Dados (Lei 13.709/2018) impacta features e arquitetura de produto. Nao e apenas um problema juridico — e um problema de produto.
+
+### Gates de Produto pela LGPD
+
+| Funcionalidade | Requisito LGPD | Implicacao para Produto |
+|---------------|---------------|------------------------|
+| Email marketing | Consentimento explicito | Double opt-in obrigatorio, preference center |
+| Analytics / cookies | Consentimento para rastreio | Cookie banner com Reject option funcional |
+| Retargeting | Consentimento para dados de ads | First-party data strategy |
+| Personalizacao | Base legal clara | Consentimento ou legítimo interesse documentado |
+| Lead capture | Transparencia no uso | Privacy policy linkada no form, finalidade clara |
+| Dados de criancas (<18) | Consentimento dos pais | Verificacao de idade obrigatoria |
+| Dados sensiveis (saude, financeiro) | Consentimento especifico | Campos separados com consent especifico |
+
+### Requisitos de UX pela LGPD
+
+```
+Formulario de cadastro deve ter:
+  [ ] Link visivel para Politica de Privacidade
+  [ ] Checkbox de consentimento nao pre-marcado
+  [ ] Opcao de opt-out de marketing separada de opt-out de servico
+
+Dentro do produto:
+  [ ] Pagina de "Meus Dados" com visualizacao
+  [ ] Botao de "Deletar minha conta e dados"
+  [ ] Historico de consentimentos
+  [ ] Export de dados pessoais (portabilidade)
+```
+
+**Direitos do titular (Art. 18) que o produto deve suportar:**
+1. Acesso — ver quais dados estao armazenados
+2. Correcao — corrigir dados incorretos
+3. Eliminacao — solicitar exclusao ("direito ao esquecimento")
+4. Portabilidade — exportar dados em formato estruturado
+5. Revogacao de consentimento — a qualquer momento
+
+**Regra pratica:** Implemente esses 5 direitos antes do launch. Remedia-los depois e mais caro. ANPD (Autoridade Nacional de Protecao de Dados) multou varias empresas em 2024-2025.
+
+## Ecossistema SaaS Brasileiro
+
+### CRMs Brasileiros
+
+| Produto | Vantagem BR | Quando usar |
+|---------|-------------|------------|
+| **RD Station CRM** | Integrado com marketing automation BR | PMEs com inbound marketing |
+| **Ploomes** | Nativo em portugues, NF integrada | Vendas B2B brasileiras |
+| **Moskit CRM** | Simples, focado em vendas BR | Times de vendas SMB |
+| **Agendor** | UX limpa, bom mobile | Startups e PMEs |
+
+### Marketing Automation Brasileira
+
+| Produto | Market Share | Diferencial |
+|---------|-------------|-------------|
+| **RD Station Marketing** | Lider no Brasil (50K+ clientes) | Ecossistema BR, suporte PT-BR |
+| **HubSpot** | Crescente em enterprise BR | Mais poderoso, ingles-first |
+| **Mailchimp** | Popular em e-commerce | Simples, barato |
+
+### Plataformas de Produto/Infoproduto
+
+| Plataforma | GMV / Escala | Relevancia |
+|-----------|-------------|------------|
+| **Hotmart** | $10B+ GMV acumulado, 188 paises | Maior plataforma de infoprodutos da AL |
+| **Eduzz** | Grande, foco em afiliados | Alternativa para criadores de conteudo |
+| **Monetizze** | Terceiro maior no BR | Foco em produtos digitais |
+| **Kiwify** | Crescendo rapidamente | Mais moderno, integracao WhatsApp |
+
+### E-commerce Infrastructure
+
+| Plataforma | Foco | Escala |
+|-----------|------|--------|
+| **VTEX** | Enterprise — Renner, Leroy, Carrefour | IPO NASDAQ, lider enterprise BR |
+| **Nuvemshop** | SMB — "Shopify brasileiro" | 100K+ lojas, 12+ bilhoes em GMV |
+| **Loja Integrada** | SMB basico | Simples e barato |
+| **Shopify (BR)** | Internacional | Crescendo mas ainda menor que VTEX/Nuvem |
+
+## Mobile-First: Numeros e Implicacoes
+
+- 60%+ do trafego digital no Brasil e mobile
+- 170M+ smartphones ativos
+- Conexoes 4G/5G cobrindo ~85% da populacao
+- Regioes Norte/Nordeste: mobile-only em muitos casos (nao tem desktop)
+
+**Implicacoes para produto:**
+
+```
+Performance mobile e critica:
+  - Core Web Vitals em mobile (INP, LCP, CLS) impactam rankings E conversao
+  - Cada segundo adicional de load: -7% de conversao (Google)
+  - Usuarios brasileiros com conexao de 4G media (10-30Mbps) — nao assuma Wi-Fi rapido
+
+UX mobile-first:
+  - Design para polegar (thumb zone) — elementos criticos na metade inferior da tela
+  - Formularios curtos — teclado virtual e frustante para muitos campos
+  - WhatsApp como action principal (nao email)
+  - Botoes de tamanho adequado para touch (min 44px)
+  - App vs. PWA: brasileiros sao mais resistentes a instalar apps — PWA funciona bem
+
+Testar em dispositivos reais:
+  - Testar em devices entry-level (Samsung A-series, Moto G) — nao so iPhone Pro
+  - Motora G Power, Samsung A54 sao devices medios tipicos no Brasil
+```
+
+## Growth no Mercado Brasileiro — Particularidades
+
+### Canais de Aquisicao Efetivos no Brasil
+
+| Canal | Efetividade | Nota Brasileira |
+|-------|-------------|----------------|
+| WhatsApp Marketing | Altissima (para B2C) | Cuidado com spam — pode ser bloqueado |
+| Instagram | Alta (B2C, infoprodutos) | Reels performam muito bem |
+| YouTube | Alta (educacional, B2B) | Segundo maior mercado do YouTube |
+| Google SEO | Alta (PT-BR menos competitivo) | Menos conteudo de qualidade = oportunidade |
+| LinkedIn | Media (B2B enterprise) | Crescendo mas menos que EUA |
+| Facebook | Media-alta (audiences 35+) | Ainda forte para faixa etaria mais velha |
+| Email (RD Station style) | Media | Double opt-in reduz volume mas aumenta engajamento |
+| Afiliados / infoprodutos | Alta (e-learning, cursos) | Ecossistema unico BR — comissoes de 30-70% |
+| Eventos / comunidades | Alta (B2B) | Presencial voltou forte pos-pandemia |
+
+### Modelos de Growth Tipicos Brasileiros
+
+**Lancamentos (Jeff Walker adaptado):**
+```
+Conteudo gratuito → Webinar/Live → Pitch → Carrinho aberto (72h) → Fechamento
+Motor: urgencia + FOMO + depoimentos em video
+Tipico de infoprodutos, cursos, mentoria
+```
+
+**Inside Sales BR:**
+```
+Inbound via conteudo (RD Station, blog, SEO) → Lead → Qualificacao (SDR) → Demo → Fechamento
+Diferencial: relacionamento antes de venda, ciclo mais longo que EUA
+```
+
+**PLG Brasil:**
+```
+Freemium (funciona bem para ferramentas de produtividade) 
+→ PIX facilitando upgrade
+→ WhatsApp para suporte low-touch
+→ Comunidade no WhatsApp/Discord como retention
+```
+
+### NPS e Cultura Brasileira
+
+Brasileiros tendem a dar NPS mais alto que americanos e europeus para o mesmo nivel de satisfacao (tendencia cultural de nao querer "ofender"). Isso significa:
+- NPS de 40 no Brasil pode equivaler a NPS de 30 em mercados mais "criticos"
+- Mais revelador do que a media: analise de comentarios qualitativos dos Detratores
+- O churn e mais revelador que o NPS como metrica de saude
+
+## BNPL (Buy Now Pay Later) e Parcelamento Cultural
+
+O Brasil tem uma das culturas de parcelamento mais fortes do mundo. "Parcelar" sem juros e diferente de "credito" na mente do consumidor brasileiro.
+
+**Implicacoes para produto:**
+- Oferecer plano anual em 12x sem juros pode aumentar conversao de plano anual em 2-3x
+- "12x de R$X" sempre ao lado do preco total — esconder o parcelamento aumenta friccao
+- Integracoes com Parcelamento PIX (2025+) vao se tornar relevantes para SaaS
+
+## Recursos e Referencias Brasileiras
+
+| Recurso | Tipo | Foco |
+|---------|------|------|
+| **Product Leaders BR (comunidade)** | Comunidade | PMs brasileiros, meetups |
+| **ProductConf BR** | Evento | Maior evento de produto do Brasil |
+| **SaaSholic** | Newsletter/comunidade | SaaS brasileiro |
+| **ABStartups** | Ecossistema | Startups brasileiras |
+| **Distrito** | Research | Ecosistema de inovacao BR |
+| **Rock Content** | Blog | Content marketing, SEO em PT-BR |
+| **RD Summit** | Evento | Maior evento de marketing digital do Brasil |
+| **CODA.BR** | Evento | Jornalismo de dados, analytics |

package/squads/squad-product/knowledge-base/customer-success-integration.md

@@ -0,0 +1,242 @@
+# Customer Success Integration
+
+## Purpose
+Framework de integracao entre produto e Customer Success — health scoring, churn prediction, expansion revenue, QBR e NPS. Produto e CS sao parceiros estrategicos, nao departamentos separados.
+
+## A Logica Financeira do CS
+
+Em modelos de receita recorrente (SaaS, subscription), CS e estrategia de receita, nao custo:
+
+- Adquirir novo cliente: 5-25x mais caro que reter existente (Bain & Company)
+- Aumento de 5% em retention pode aumentar lucro em 25-95%
+- NRR > 100% significa crescimento mesmo com zero novos clientes
+- O produto que os clientes mais usam e o produto que mais retêm
+
+**Consequencia para produto:** Cada decisao de produto deve considerar impacto no retention e expansion. Feature que adquire mas nao retêm e ineficiente.
+
+## Net Revenue Retention (NRR) — A Metrica Definitiva
+
+```
+NRR = (MRR Inicio + Expansion - Contraction - Churn) / MRR Inicio × 100
+```
+
+| NRR | Qualidade | Exemplos |
+|-----|-----------|----------|
+| >130% | World-class | Datadog (~130%), Twilio historico |
+| 120-130% | Excelente | Snowflake (~125%), MongoDB (~120%) |
+| 110-120% | Bom | Maioria dos SaaS saudaveis |
+| 100-110% | OK, precisa melhorar | Crescimento depende de novos clientes |
+| <100% | Problematico — "leaky bucket" | Perdendo receita existente |
+
+**NRR decomposicao:**
+```
+NRR = Logo Retention × Revenue per Customer Growth
+```
+- Se muitos clientes saem mas os que ficam expandem → NRR pode parecer OK mas e fragil
+- NRR saudavel = alta logo retention + expansion de clientes satisfeitos
+
+## Health Score — Prever Churn Antes que Aconteca
+
+Health Score combina sinais quantitativos e qualitativos para indicar risco de churn. Produto deve instrumentar os sinais corretamente.
+
+### Componentes Tipicos
+
+| Sinal | Peso Sugerido | Como Medir | Responsavel |
+|-------|--------------|-----------|-------------|
+| Product Usage | 30% | DAU/MAU, feature adoption, login frequency | Produto |
+| Support Tickets | 15% | Volume, severidade, tempo de resolucao | CS + Suporte |
+| NPS/CSAT | 15% | Score de satisfacao | CS |
+| Engagement com CS | 15% | Respostas a emails, participacao em QBRs | CS |
+| Billing Health | 10% | Pagamentos em dia, downgrades | Financeiro |
+| Champion Status | 15% | Champion ativo, engajado, crescendo na empresa | CS |
+
+### Bandas de Health Score
+
+```
+GREEN  (80-100): Saudavel — candidato a expansion e referral
+YELLOW (50-79):  Atencao — intervencao proativa necessaria antes que piore
+RED    (0-49):   Risco alto — escalar imediatamente, executive involvement
+```
+
+### Sinais de Alerta Precoce (Leading Indicators de Churn)
+
+- Login frequency caiu >30% MoM
+- Champion saiu da empresa
+- Support tickets criticos abertos >7 dias sem resolucao
+- Nao responde emails do CSM ha >2 semanas
+- Nao participou da ultima QBR
+- Downgrade request ou reducao de seats
+- Competidor mencionado em calls (capturar via Gong ou notas de CS)
+- Pagamento atrasado
+
+**Para produto:** Instrumentar eventos de "health" no produto — login drops, feature abandonment, e invitations declined sao todos sinais que o produto pode monitorar e alertar ao CS.
+
+## Expansion Revenue — Upsell & Cross-Sell
+
+**Upsell** — Mais do mesmo: mais seats, tier superior, features premium
+**Cross-sell** — Produtos complementares: modulo adicional, servico, integracoes
+
+### Playbook de Expansion por Trigger
+
+| Trigger | Momento | Acao | Owner |
+|---------|---------|------|-------|
+| Uso atinge 80% do limite | Automatico via produto | In-app nudge + CSM outreach | Produto + CS |
+| QBR mostra ROI forte | Trimestral | CSM propoe expansion na QBR | CS |
+| Cliente levanta rodada de investimento | Event-based | Outreach proativo de expansion | CS + AE |
+| Champion promovido | Event-based | Re-engage com novo escopo | CS |
+| Renovacao: 90 dias antes | Time-based | Proposta de upgrade com incentivo | CS + AE |
+| Power user atinge N acoes | Behavioral | PQL alert para CS | Produto → CS |
+
+### PQL para Expansion (Product-Qualified Lead)
+
+Usuarios que demonstram intencao de expansao atraves de comportamento:
+
+```
+Sinais de PQL de Expansion:
++ Convidou X novos membros (proximity ao limite de seats)
++ Acessou pagina de pricing de upgrade
++ Usou feature premium (disponivel em tier superior) durante trial ou preview
++ Exportou dados em volume alto (sinal de valor real do produto)
++ Admin activity crescente (sinalizando adocao organizacional)
+
+Score de PQL de Expansion:
+  > 70: Alert para CSM — oportunidade quente
+  50-70: Monitorar, preparar proposta de valor
+  < 50: Nurture com conteudo de feature discovery
+```
+
+## QBR — Quarterly Business Review
+
+A QBR e o ritual mais importante da relacao CS-Cliente para demonstrar valor e identificar expansion.
+
+### Agenda Recomendada (60-90 minutos)
+
+**Revisao de Valor (20 min)**
+- Metricas de ROI do trimestre
+- Comparacao com baseline e goals acordados
+- Feature adoption e health score
+- "No ultimo trimestre, voces economizaram X horas / aumentaram Y em Z"
+
+**Challenges & Feedback (15 min)**
+- Frustrações, problemas nao resolvidos
+- Voice of Customer — o que o roadmap nao esta endereçando
+- Competidores mencionados? Por que?
+
+**Roadmap Preview (15 min)**
+- Features proximas relevantes para o cliente
+- Perguntar: "Quais dessas mudancas mais impactam sua operacao?"
+
+**Plano de Acao — Proximo Trimestre (20 min)**
+- Goals conjuntos para o proximo periodo
+- Oportunidades de expansion identificadas
+- Proximos passos e responsaveis de cada lado
+
+### Regras de QBR Eficaz
+
+- **Trazer dados, nao opinioes** — ROI, adoption rates, tickets resolvidos
+- **Convidar stakeholders de nivel sênior** dos dois lados, nao so operacional
+- **Red flag:** Se o cliente nao aparece na QBR → health está em risco
+- **Seguir com follow-up escrito em 24h** com resumo das decisoes e proximos passos
+- **Nunca usar QBR apenas para upsell** — deve entregar valor real antes de pedir expansao
+
+## NPS — Net Promoter Score
+
+```
+NPS = % Promoters (9-10) - % Detractors (0-6)
+
+Classificacao:
+  Promoters (9-10): Advogam pelo produto ativamente
+  Passives (7-8): Satisfeitos mas sem entusiasmo
+  Detractors (0-6): Insatisfeitos, podem gerar churn e negative WOM
+
+Benchmarks SaaS:
+  < 0:   Preocupante — mais detratores que promotores
+  0-30:  OK
+  30-50: Bom
+  50-70: Excelente
+  > 70:  World-class (Slack historicamente 70+, Apple 72+)
+```
+
+### NPS Closing the Loop
+
+O valor real do NPS esta em **agir sobre o feedback**, nao em medir:
+
+| Score | Acao | Timeline |
+|-------|------|----------|
+| 9-10 (Promoter) | Thank, ask for referral, case study, LinkedIn review | 48h |
+| 7-8 (Passive) | Ask what would make it 9-10, address gap | 1 semana |
+| 0-6 (Detractor) | CSM reach out pessoal, entender problema, recovery plan | 24h — urgente |
+
+**Para produto:** NPS por feature/area identifica onde o produto esta falhando. Segmentar por plano, cohort e comportamento revela padroes acionaveis.
+
+## Churn Analysis — Modelos e Tipos
+
+### Tipos de Churn
+
+| Tipo | Definicao | Como Enderecar |
+|------|-----------|---------------|
+| **Voluntary** | Usuario decidiu sair (insatisfacao, alternativa) | Discovery da causa raiz — produto ou CS |
+| **Involuntary** | Falha de pagamento, cartao expirado | Dunning management — emails automaticos |
+| **Logo churn** | Clientes perdidos (headcount) | Health score + proactive CS |
+| **Revenue churn** | Receita perdida — pode ser diferente de logo churn | Focar nos clientes de maior ACV |
+
+### Metodos de Analise
+
+1. **Survival Analysis** — Kaplan-Meier curves: probabilidade de churn ao longo do tempo
+2. **Cohort Analysis** — Retencao por cohort: tendencias estao melhorando ou piorando?
+3. **Behavioral Segmentation** — Que comportamentos precedem churn 30-60-90 dias antes?
+4. **Exit Surveys** — Perguntar diretamente por que o usuario esta saindo (qualitativo)
+5. **Predictive Modeling** — ML para identificar clientes em risco antes do churn acontecer
+
+### Modelo Preditivo de Churn (Features Tipicas)
+
+```
+Features para modelo de ML:
+- Usage patterns (frequencia, profundidade, recencia)
+- Support interactions (volume, severidade, nao-resolucao)
+- NPS trends (piora recente?)
+- Billing history (atrasos, downgrades)
+- Champion activity (login do champion caiu?)
+- Onboarding completion (completou setup inicial?)
+- Competitor activity (mencionado em calls?)
+
+Modelos comuns:
+  Baseline: Logistic regression
+  Intermediario: Random forest
+  Avancado: XGBoost ou LightGBM
+
+Horizon: 30-90 dias de antecedencia (suficiente para intervencao)
+Threshold: alertar CS quando probabilidade > 30% (calibrar para o negocio)
+```
+
+## Integracao Produto + CS — Feedback Loop
+
+O produto precisa consumir sinais de CS e CS precisa consumir dados do produto. O loop nao acontece por acidente:
+
+```
+CS → Produto:
+  - Feature requests de multiplos clientes (padrao = sinal valido)
+  - Razoes de churn (produto vs. processo vs. mercado?)
+  - "Aha moments" nao capturados pelo analytics
+  - Gaps na proposta de valor vs. expectativa do cliente
+
+Produto → CS:
+  - PQL alerts (usuario pronto para expansion)
+  - Health score drops automaticos
+  - Feature adoption data (quais features mais adotadas por quem)
+  - Onboarding completion drops
+  - Novos features lancados que CSMs devem usar em QBRs
+```
+
+**Ritual recomendado:** Monthly Product-CS sync de 45 min — CS traz top 5 feature requests e top 5 churn signals. Produto traz adoption data e roadmap relevante para CS conversations.
+
+## Benchmarks de CS em SaaS
+
+| Metrica | Average SaaS | Excelente | Source |
+|---------|-------------|-----------|--------|
+| Logo Churn (anual) | 5-10% | <5% | OpenView |
+| Revenue Churn (anual) | 5-7% | <3% | KeyBanc |
+| NRR | 100-110% | >120% | KeyBanc SaaS Survey |
+| NPS | 30-40 | >50 | Bain |
+| QBR participation rate | 60-70% | >80% | Gainsight |
+| Time to identify at-risk | >30 days lag | <7 days | Gainsight |

package/squads/squad-product/knowledge-base/discovery-methodology-playbook.md

@@ -6,6 +6,93 @@ Guia pratico de metodologias de discovery com instrucoes de quando e como usar c
 ## Core Philosophy
 Discovery is a continuous habit, not a phase. The goal is to reduce risk before investing in development by gathering evidence about user needs, market context, and solution viability.
 
+## Continuous Discovery Habits — Teresa Torres (Deep Reference)
+
+Teresa Torres (Continuous Discovery Habits, 2021) formalizou o framework mais completo de discovery moderno. Central piece: o **Opportunity Solution Tree (OST)**.
+
+### Opportunity Solution Tree
+
+```
+Desired Outcome (metrica de negocio — ex: aumentar retencao D30)
+├── Opportunity 1 (problema/necessidade do usuario)
+│   ├── Solution A → Assumption Map → Experiment
+│   ├── Solution B → Assumption Map → Experiment
+│   └── Solution C → Assumption Map → Experiment
+├── Opportunity 2 (problema/necessidade do usuario)
+│   ├── Solution A → Assumption Map → Experiment
+│   └── Solution B → Assumption Map → Experiment
+└── Opportunity 3 (problema/necessidade do usuario)
+    └── Solutions...
+```
+
+**Principios da OST:**
+1. Outcomes sao metricas de negocio — nao features, nao outputs
+2. Opportunities sao necessidades, desejos e pain points dos usuarios — nao solucoes
+3. Solutions devem ser testadas via experimentos antes de serem construidas
+4. Product Trio (PM + Design + Engineering) trabalha junto — nao PM sozinho
+
+### Weekly Touchpoints (O Habito Central)
+
+Torres argumenta que o maior erro em discovery e fazer pesquisa em "fases" — um sprint de discovery antes de um sprint de desenvolvimento. Isso cria gaps de feedback lentos.
+
+**O habito semanal:**
+```
+Toda semana:
+  - Pelo menos 1 entrevista com usuario (produto trio presente)
+  - Sintetizar insights no OST
+  - Identificar oportunidades novas ou validar/invalidar existentes
+  - Decidir experimento para a proxima semana
+```
+
+**Por que semanal?**
+- Ciclos mensais = 12 aprendizados por ano
+- Ciclos semanais = 52 aprendizados por ano
+- A velocidade de aprendizado determina a velocidade de product-market fit
+
+### Assumption Mapping
+
+Antes de construir qualquer solucao, mapear as hipoteses que precisam ser verdadeiras para a solucao funcionar:
+
+```
+Para cada solucao identificada na OST:
+  1. Listar todas as hipoteses (desirable / viable / feasible / usable)
+  2. Rankear por: [impacto no resultado] × [incerteza]
+  3. A hipotese mais critica e mais incerta = proximo experimento
+  
+Quadrantes:
+  Alta incerteza + Alto impacto → Testar primeiro
+  Alta incerteza + Baixo impacto → Testar depois
+  Baixa incerteza + Alto impacto → Monitorar
+  Baixa incerteza + Baixo impacto → Ignorar (por ora)
+```
+
+**Tipos de hipoteses:**
+- **Desirability:** Usuarios querem isso? Resolve o problema deles?
+- **Viability:** O negocio pode sustentar isso? (preco, operacao, legal)
+- **Feasibility:** O time consegue construir isso? (tech, tempo, recursos)
+- **Usability:** Os usuarios conseguem usar? (UX, aprendizado)
+
+### Story Mapping (Jeff Patton)
+
+Story maps visualizam a jornada do usuario com o produto para identificar oportunidades de discovery:
+
+```
+Activities (niveis altos da jornada):
+  Descobrir → Registrar → Configurar → Usar → Compartilhar
+
+Tasks (acoes especificas por activity):
+  Descobrir: [busca Google] [ver ad] [recomendacao amigo]
+  Registrar: [criar conta] [verificar email] [configurar perfil]
+  ...
+
+Stories (detalhes de implementacao) ficam abaixo das tasks
+```
+
+Story mapping e especialmente util para:
+- Identificar lacunas na jornada atual
+- Priorizar o "walking skeleton" (fluxo minimo de valor)
+- Alinhar toda a equipe na visao do produto
+
 ## Method Selection Guide
 
 ### By Research Question Type
@@ -77,6 +164,58 @@ Behavioral (WHAT THEY DO) + Attitudinal (WHAT THEY SAY) = Complete Picture
 - Allow participants to stop at any time
 - Never deceive participants about product intent
 
+## Jobs-to-be-Done (JTBD) — Deep Reference
+
+Clayton Christensen / Bob Moesta framework para entender a motivacao real por tras de comportamentos do usuario.
+
+### Os 3 Tipos de Job
+
+```
+Functional Job: O que o usuario quer fazer
+  "Enviar arquivo grande rapidamente para um cliente"
+
+Emotional Job: Como quer se sentir ao fazer isso
+  "Parecer profissional e organizado"
+
+Social Job: Como quer ser percebido pelos outros
+  "Ser o tipo de pessoa que usa ferramentas modernas"
+```
+
+**Para produto:** Construir para o Functional Job sem considerar Emotional e Social Job frequentemente cria produtos tecnicamente corretos mas que ninguem adota.
+
+### Switch Interview (Bob Moesta)
+
+Para entender por que usuarios mudaram de produto (ou adotaram o novo):
+
+```
+Timeline Interview:
+  1. "Quando voce primeiro pensou em procurar uma alternativa?"
+  2. "O que aconteceu que fez isso urgente?"
+  3. "O que voce fez primeiro?" (buying journey)
+  4. "Quais outras opcoes voce considerou?"
+  5. "Por que voce escolheu [nosso produto]?"
+  6. "Como foi o primeiro uso? O que voce esperava?"
+  7. "O que mudou desde que voce comecou a usar?"
+```
+
+### Four Forces of Progress (Bob Moesta)
+
+Para entender por que um usuario muda (ou nao muda) de produto:
+
+```
+Forces pulling TOWARDS mudanca:
+  + Push: frustracao com a solucao atual ("isso me atrasa toda semana")
+  + Pull: atracao pela nova solucao ("ouvi que funciona perfeitamente para X")
+
+Forces pulling AGAINST mudanca:
+  - Habit: inertia da solucao atual ("ja sei como usar")
+  - Anxiety: medo de que a nova nao funcione ("e se perder meus dados?")
+
+Mudanca so acontece quando Push + Pull > Habit + Anxiety
+```
+
+**Aplicacao para produto:** Se usuarios nao adotam, a causa pode ser Push insuficiente (problema nao e grande o suficiente) ou Anxiety muito alta (onboarding assustador, dados de migracao).
+
 ## Common Pitfalls
 | Pitfall | Prevention |
 |---------|-----------|
@@ -86,3 +225,5 @@ Behavioral (WHAT THEY DO) + Attitudinal (WHAT THEY SAY) = Complete Picture
 | Recency bias | Look at patterns, not individual stories |
 | Survivorship bias | Include churned/inactive users |
 | Selection bias | Recruit diverse participants |
+| Discovery theater | Fazer entrevistas sem conectar insights ao OST e ao backlog |
+| HiPPO override | Dados de usuarios devem superar opinioes de stakeholders — documentar evidencia |