iron-edge 1.0.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/chrome-brain-integration.md

@@ -0,0 +1,49 @@
+# Chrome Brain Integration — Squad Product (Orbit)
+
+> Squad Product tem acesso ao Chrome Brain para analise de produtos concorrentes, mapeamento de user journeys, captura de onboarding flows e benchmark de funcionalidades.
+
+## Tier: 3
+
+## Quando Ativar
+
+- Analise de produto concorrente (funcionalidades, pricing, UX, fluxos)
+- Captura de onboarding flows e product tours de referencia
+- Mapeamento de user journey em aplicacoes web
+- Benchmark de funcionalidades e features entre competidores
+
+## O Que Recebe do Chrome Brain
+
+- Screenshots de funcionalidades de produtos concorrentes
+- Onboarding flows capturados passo a passo
+- User journey mapeado com screenshots e navegacao
+- Pricing pages e feature comparison tables extraidas
+
+## O Que Envia pro Chrome Brain
+
+N/A para esta squad
+
+## Tools Disponiveis
+
+1. **Chrome DevTools MCP** (29 tools) — acoes rapidas, screenshots, audit
+2. **dev-browser** — scraping complexo, batch operations
+3. **claude-in-chrome** — fallback visual
+
+## Session Management
+
+- Max 15 screenshots por sessao
+- Salvar outputs em arquivo antes de acumular
+- Rotacionar sessao a cada ~12 screenshots
+
+## NSN Mode
+
+Ativo. Se uma acao de browser falhar, tentar alternativas automaticamente.
+Buscar solucao na internet. Configurar, testar, repetir. Max 5 ciclos.
+
+## Auto-Learning
+
+Ao descobrir novo pattern ou resolver barreira via NSN, atualizar:
+`~/.sinapse/sinapse/knowledge-base/chrome-brain.md` secao Learnings Log
+
+## Referencia Completa
+
+`~/.sinapse/sinapse/knowledge-base/chrome-brain.md`

package/squads/squad-product/knowledge-base/client-stakeholder-management-protocols.md

@@ -0,0 +1,54 @@
+# Client & Stakeholder Management Protocols
+
+## Purpose
+Protocolos de gestao de stakeholders e clientes para agencia, incluindo comunicacao, escalacao e gestao de expectativas.
+
+## Stakeholder Mapping (Power/Interest Grid)
+```
+HIGH POWER │ MANAGE CLOSELY  │ KEEP SATISFIED
+           │ (Key Players)    │ (Context Setters)
+           │ Regular meetings │ Periodic updates
+           ├──────────────────┼──────────────────
+           │ KEEP INFORMED    │ MONITOR
+LOW POWER  │ (Subjects)       │ (Crowd)
+           │ Status updates   │ General comms
+           └──────────────────┴──────────────────
+           HIGH INTEREST       LOW INTEREST
+```
+
+## Communication Cadence Matrix
+| Stakeholder Type | Channel | Frequency | Content | Owner |
+|-----------------|---------|-----------|---------|-------|
+| Executive Sponsor | Email + QBR | Monthly + Quarterly | Strategic updates, ROI | Client PM |
+| Client PO | Slack + Weekly sync | Daily async + Weekly | Decisions, priorities | Client PM |
+| Technical Lead | Standup | Daily | Implementation details | Delivery Mgr |
+| End Users | In-product + Survey | Quarterly | Feature updates, feedback | Discovery Lead |
+| Finance | Email | Monthly | Budget utilization | Client PM |
+
+## Escalation Protocol
+| Level | Trigger | Response Time | Responder |
+|-------|---------|-------------|-----------|
+| L1 | Communication issue, minor delay | Same day | PM |
+| L2 | Budget concern, priority disagreement | 24h | PM + Lead |
+| L3 | Contract dispute, strategic misalignment | 48h | Leadership |
+| L4 | At-risk account, potential churn | Immediate | Executive |
+
+## Difficult Conversation Templates
+
+### Delivering Bad News
+"I want to share an update on [topic]. We encountered [specific issue]. The impact is [clear description]. We are addressing it by [action plan]. We expect resolution by [timeline]. I want to discuss [any decisions needed from you]."
+
+### Pushing Back on Scope
+"I understand this is important because [their reason]. Let me share what this would involve: [impact]. I see three options: [Option A], [Option B], [Option C]. I recommend [option] because [rationale]. What would you prefer?"
+
+### Requesting Client Action
+"To keep [project] on track, we need [specific deliverable] by [date]. This is blocking [what it blocks]. If delayed, the impact would be [consequence]. Can you commit to this timeline?"
+
+## Client Health Indicators
+| Signal | Health | Action |
+|--------|--------|--------|
+| Responds quickly, engaged in meetings | Healthy | Maintain |
+| Slow responses, cancels meetings | Attention | Proactive check-in |
+| Complaints, negative feedback | At Risk | Recovery plan |
+| Champion leaves organization | Critical | Relationship rebuild |
+| Requests data export | Churn Risk | Executive escalation |

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 |