sinapse-ai 9.3.0 → 9.4.0

package/squads/squad-paidmedia/knowledge-base/routing-catalog.md

@@ -1,26 +1,103 @@
-# Routing Catalog — Paid Media
+# Routing Catalog — Paid Media Squad
 
 Maps keywords and domains to specialist agents for intelligent routing within the Paid Media squad.
 
-<!-- TODO: expand content -->
+---
 
 ## Domain Routing Matrix
 
 | Domain | Keywords | Primary Agent | Secondary Agent |
 |--------|----------|--------------|-----------------|
-| Meta/Facebook Ads | Meta ads, Facebook ads, Instagram ads, feed ads, reel ads, Meta pixel | meta-ads-specialist | campaign-analyst |
-| Google Ads | Google ads, search ads, YouTube ads, display, Performance Max, shopping | google-ads-specialist | campaign-analyst |
-| Campaign strategy | campaign strategy, media plan, channel mix, budget allocation, funnel | paidmedia-orqx | campaign-analyst |
-| Creative strategy | ad creative, creative testing, video ads, static vs video, hooks, angles | creative-strategist | meta-ads-specialist |
-| CRO & landing pages | landing page, CRO, conversion rate, A/B test, form optimization | cro-specialist | performance-engineer |
-| Performance & tracking | tracking, pixel, CAPI, UTM, attribution, analytics, tag manager | performance-engineer | campaign-analyst |
-| Campaign analysis | report, ROAS, CPA, CPL, performance analysis, metrics, dashboard | campaign-analyst | paidmedia-orqx |
-| Scaling | scaling, budget increase, horizontal scaling, vertical scaling, CBO | meta-ads-specialist | google-ads-specialist |
-| Audience targeting | audience, lookalike, interest targeting, retargeting, custom audience | meta-ads-specialist | campaign-analyst |
-| Bid strategy | bidding, cost cap, bid cap, tCPA, tROAS, smart bidding, manual CPC | google-ads-specialist | meta-ads-specialist |
-
-## Usage Notes
-
-- Route to the **Primary Agent** by default for each domain.
-- Use the **Secondary Agent** when the primary is overloaded or when the request spans multiple domains.
-- For requests that span multiple domains, the orchestrator (paidmedia-orqx) coordinates handoffs.
+| **Meta/Facebook Ads** | meta ads, facebook ads, instagram ads, feed ads, reel ads, meta pixel, CAPI, advantage+, CBO, ABO, ASC, ODAX | meta-ads-specialist (Signal) | campaign-analyst (Pulse) |
+| **Google Ads — Search** | google search ads, RSA, keywords, match types, negative keywords, quality score, smart bidding, tCPA, tROAS | google-ads-specialist (Query) | campaign-analyst (Pulse) |
+| **Google Ads — Shopping** | google shopping, performance max, pmax, merchant center, product feed, ROAS | google-ads-specialist (Query) | campaign-analyst (Pulse) |
+| **Google Ads — YouTube** | youtube ads, skippable, bumper, TrueView, video action campaign, YouTube shorts ads | google-ads-specialist (Query) | creative-strategist (Canvas) |
+| **Google Ads — Display** | GDN, display ads, responsive display, remarketing google, affinity, in-market | google-ads-specialist (Query) | campaign-analyst (Pulse) |
+| **TikTok Ads** | tiktok ads, spark ads, in-feed ads, topview, tiktok creative center, FYP ads, tiktok shop ads | meta-ads-specialist (Signal) | creative-strategist (Canvas) |
+| **LinkedIn Ads** | linkedin ads, sponsored content, inmail, lead gen forms, ABM linkedin, B2B linkedin, insight tag | meta-ads-specialist (Signal) | campaign-analyst (Pulse) |
+| **Programmatic & DSPs** | programmatic, DSP, DV360, the trade desk, RTB, header bidding, ad exchange, SSP, viewability, brand safety | performance-engineer (Lighthouse) | campaign-analyst (Pulse) |
+| **Campaign strategy** | campaign strategy, media plan, channel mix, budget allocation, funnel, cross-channel | paidmedia-orqx (Apex) | campaign-analyst (Pulse) |
+| **Creative strategy** | ad creative, creative testing, video ads, static vs video, hooks, angles, UGC, AIDA, PAS, BAB, hook rate, 3 second rule | creative-strategist (Canvas) | meta-ads-specialist (Signal) |
+| **CRO & landing pages** | landing page, CRO, conversion rate, A/B test, form optimization, page speed, core web vitals | cro-specialist (Convert) | performance-engineer (Lighthouse) |
+| **Performance & tracking** | tracking, pixel, CAPI, UTM, attribution, analytics, tag manager, GA4, EMQ, event match quality | performance-engineer (Lighthouse) | campaign-analyst (Pulse) |
+| **Attribution & MMM** | attribution, MMM, media mix modeling, incrementality, lift study, Robyn, Meridian, MER, blended ROAS | campaign-analyst (Pulse) | paidmedia-orqx (Apex) |
+| **Campaign analysis** | report, ROAS, CPA, CPL, performance analysis, metrics, dashboard, MER, blended CPA, LTV:CAC | campaign-analyst (Pulse) | paidmedia-orqx (Apex) |
+| **Scaling** | scaling, budget increase, horizontal scaling, vertical scaling, CBO, diminishing returns, marginal CPA | meta-ads-specialist (Signal) | google-ads-specialist (Query) |
+| **Audience targeting** | audience, lookalike, interest targeting, retargeting, custom audience, CDP, first-party data, Value Rules | meta-ads-specialist (Signal) | campaign-analyst (Pulse) |
+| **Bid strategy** | bidding, cost cap, bid cap, tCPA, tROAS, smart bidding, manual CPC, value optimization | google-ads-specialist (Query) | meta-ads-specialist (Signal) |
+| **Social algorithms** | instagram algorithm, tiktok algorithm, youtube algorithm, linkedin algorithm, reels algorithm, FYP, batch testing | creative-strategist (Canvas) | campaign-analyst (Pulse) |
+| **Social commerce** | live commerce, tiktok shop, instagram shopping, social commerce, shoppable posts | meta-ads-specialist (Signal) | creative-strategist (Canvas) |
+| **Brazil market** | mercado brasileiro, PIX, WhatsApp ads, click-to-WhatsApp, sazonalidade brasil, CONAR, benchmarks brasil | paidmedia-orqx (Apex) | campaign-analyst (Pulse) |
+| **AI & automation** | AI ads, DCO, dynamic creative, advantage+ creative, GEM meta, AI max google, automation | creative-strategist (Canvas) | performance-engineer (Lighthouse) |
+| **Competitive intel** | competitor ads, ad library, ad spy, facebook ad library, google transparency center | campaign-analyst (Pulse) | meta-ads-specialist (Signal) |
+
+---
+
+## Agent Profiles
+
+| Agent | ID | Especialidade |
+|-------|-----|--------------|
+| **Apex** | paidmedia-orqx | Orquestração, cross-channel strategy, budget allocation |
+| **Signal** | meta-ads-specialist | Meta Ads, Instagram, TikTok, LinkedIn |
+| **Query** | google-ads-specialist | Google Search, Display, YouTube, Shopping, PMax |
+| **Canvas** | creative-strategist | Creative strategy, UGC, hooks, social algorithms |
+| **Convert** | cro-specialist | Landing pages, CRO, form optimization |
+| **Lighthouse** | performance-engineer | Tracking, Pixel, CAPI, GA4, programmatic |
+| **Pulse** | campaign-analyst | Analytics, reporting, attribution, benchmarks |
+
+---
+
+## Routing Decision Rules
+
+1. **Route to Primary Agent** por default para cada domain
+2. **Use Secondary Agent** quando:
+   - O primary está sobrecarregado
+   - Request abrange múltiplos domains
+3. **Request multi-domain:** O orchestrator (paidmedia-orqx) coordena handoffs
+4. **Requests novos canais** (TikTok, LinkedIn): Route para Signal (meta-ads-specialist)
+5. **Requests programmatic/DSP:** Route para Lighthouse (performance-engineer)
+
+---
+
+## Quick Decision Tree
+
+```
+Paid traffic request?
+├── Meta/Instagram/Facebook → Signal
+├── TikTok/LinkedIn ads → Signal
+├── Google Search/Shopping/PMax → Query
+├── YouTube ads → Query (strategy) + Canvas (creative)
+├── Creative/UGC/Hooks → Canvas
+├── Tracking/CAPI/Pixel → Lighthouse
+├── Landing page/CRO → Convert
+├── Attribution/MMM/Analytics → Pulse
+├── Budget allocation/cross-channel → Apex
+├── Brazilian market/PIX/WhatsApp → Apex (context) + Signal/Query (execution)
+└── Programmatic/DSP/RTB → Lighthouse
+```
+
+---
+
+## Knowledge Base Index
+
+| KB File | Conteúdo | Agents Primários |
+|---------|---------|-----------------|
+| `meta-ads-campaign-architecture.md` | Estrutura de campanhas Meta, CBO/ABO, ODAX, Advantage+, Andromeda | Signal |
+| `meta-ads-optimization-playbook.md` | Marginal CPA, creative fatigue, CAPI implementation, cadência de otimização | Signal, Pulse |
+| `meta-ads-scaling-framework.md` | 4 phases de scaling, risk triggers, creative velocity | Signal, Apex |
+| `google-ads-account-architecture.md` | Estruturas de conta, keyword strategy, QS, Smart Bidding, PMax, AI Max | Query |
+| `google-ads-optimization-playbook.md` | Search term hygiene, negative keywords, budget pacing, conversion tracking | Query |
+| `tiktok-linkedin-ads-playbook.md` | TikTok Ads (Spark, TopView, Creative Center), LinkedIn Ads (ABM, Lead Gen) | Signal |
+| `programmatic-attribution-deep.md` | RTB, DSPs, DV360, The Trade Desk, MMM (Robyn/Meridian), Incrementality, Privacy Sandbox | Lighthouse, Pulse |
+| `creative-strategy-deep.md` | 3s rule, UGC, AIDA/PAS/BAB, Schwartz levels, ad fatigue, ODAX, AI ads | Canvas |
+| `audiences-segmentation-deep.md` | Cold/Warm/Hot audiences, CDP, first-party data, LAL strategy, predictive audiences | Signal, Query |
+| `creative-testing-framework.md` | Hypothesis formation, sample size, hook formulas, success criteria | Canvas |
+| `cro-conversion-optimization.md` | Form friction, progressive profiling, A/B testing, activation | Convert |
+| `analytics-reporting-frameworks.md` | Attribution models, funnel analysis, anomaly detection, period comparison | Pulse |
+| `paid-media-metrics-reference.md` | Todas as métricas, fórmulas, benchmarks por vertical | Pulse, todos |
+| `social-algorithms-playbook.md` | Instagram/TikTok/YouTube/LinkedIn/X algorithms, Two-Tower, batch testing | Canvas |
+| `brazil-market-context.md` | CPM benchmarks BR, PIX, WhatsApp CTW, sazonalidade, CONAR, live commerce | Apex, Signal |
+| `competitive-ad-intelligence.md` | Ad Library, Transparency Center, multi-platform audit | Pulse |
+| `traffic-masters-frameworks.md` | Depesh Mandalia, Molly Pittman, Kasim Aslam, Hormozi, Schwartz — frameworks elite | todos |
+| `video-ad-production-guide.md` | Produção de vídeo para ads | Canvas |
+| `local-seo-gmb-playbook.md` | Local SEO, Google Meu Negócio | Query |

package/squads/squad-paidmedia/knowledge-base/traffic-masters-frameworks.md

@@ -35,3 +35,74 @@ Advanced paid media frameworks from elite practitioners.
 - **Regra do 1-3-5:** 1 campanha, 3 conjuntos, 5 anúncios por conjunto
 - **Orçamento Mínimo:** R$ 10-20/dia por conjunto para otimização do algoritmo
 - **Método de Escala:** Duplicar conjuntos vencedores com +20% orçamento a cada 3 dias
+
+---
+
+## Eugene Schwartz — 5 Níveis de Consciência (Breakthrough Advertising, 1966)
+**Source:** Breakthrough Advertising
+Framework mais importante de copy para paid media — define qual mensagem usar por audiência:
+
+| Nível | Estado | Hook/Mensagem Ideal |
+|-------|--------|---------------------|
+| **Unaware** | Não sabe que tem o problema | Mostrar sintomas, não o produto |
+| **Problem Aware** | Sabe do problema, não conhece soluções | Validar a dor, apresentar existência de solução |
+| **Solution Aware** | Conhece soluções, não conhece sua marca | Diferenciar sua solução |
+| **Product Aware** | Conhece sua solução, não tomou ação | Proposta de valor, objeções, urgência |
+| **Most Aware** | Conhece e quase comprou | Oferta, desconto, detalhe final |
+
+**Aplicação prática:** Prospecting cold = níveis 1-2. Retargeting warm = 3-4. Retargeting hot = 5.
+
+---
+
+## Alex Hormozi — $100M Leads Framework (2023)
+**Source:** $100M Leads (Acquisition.com, 2023)
+- **Core Offer:** Oferta central irresistível como base de toda campanha
+- **Lead Magnet:** Isca de valor para gerar lead (problema único → solução única → CTA específico)
+- **Volume-Based Strategy:** Mais volume de anúncios testados = mais chances de winner
+- **Dream Outcome:** Comunicar o resultado desejado, não o produto/serviço
+- **Grandslam Offer:** Value = Dream Outcome × Likelihood / Time Delay × Effort
+
+---
+
+## Kasim Aslam — Solutions 8 Google Ads (atualizado 2025)
+**Source:** Solutions 8 YouTube
+- **PMax Structure:** Asset group por tema, não por produto (consistência criativa)
+- **Alpha/Beta:** Alpha (exact match winners) → Beta (broad match exploration)
+- **Negative Keyword Sculpting:** Exclusões sistemáticas para forçar tráfego para campanhas corretas
+- **PMax Negative KWs:** Desde jan/2025, negative keywords disponíveis por campanha (até 10K)
+- **Channel Reporting:** Desde nov/2025, breakdown por canal em PMax disponível
+
+---
+
+## Savannah Sanchez — UGC Creative Strategy (The Social Savannah)
+**Source:** The Social Savannah
+- **Native-first:** Criativos que parecem conteúdo orgânico superam criativos polished consistentemente
+- **Hook diversity:** Testar 5+ tipos de hooks antes de declarar ângulo vencedor
+- **Creator brief structure:** Problema → Agitação → Solução → Prova → CTA em UGC
+- **Batch production:** Gravar 5-10 variações no mesmo dia para eficiência
+- **Authenticity signals:** Sem marca d'água de outras plataformas, sem edição excessiva, fundo natural
+
+---
+
+## Aaron Young — Google Shopping Optimization (Define Digital Academy)
+**Source:** Define Digital Academy
+- **Product Title Priority:** Título do produto é o campo mais importante — incluir keywords (ex: "Tênis Nike Revolution 6 Masculino Preto")
+- **Feed-first approach:** Qualidade do feed determina resultado em Shopping e PMax
+- **Priority System (Standard Shopping):** High/Medium/Low priority para controlar qual campanha captura qual busca
+- **GTIN obrigatório:** Produtos sem GTIN têm menor eligibilidade e performance
+
+---
+
+## Livros-Bíblia do Paid Media
+
+| Livro | Autor | Ano | Por Que É Essencial |
+|-------|-------|-----|---------------------|
+| **Scientific Advertising** | Claude Hopkins | 1923 | Fundação do teste A/B e publicidade científica |
+| **Breakthrough Advertising** | Eugene Schwartz | 1966 | 5 níveis de consciência — framework de copy mais importante |
+| **Ogilvy on Advertising** | David Ogilvy | 1983 | Princípios de headline e copy ainda válidos |
+| **Influence** | Robert Cialdini | 1984 | 6 gatilhos de persuasão aplicados a ads |
+| **Ultimate Guide to Google Ads** | Perry Marshall | 2020 | Guia mais completo de Google Ads |
+| **$100M Leads** | Alex Hormozi | 2023 | Framework de lead gen incluindo paid ads |
+| **$100M Offers** | Alex Hormozi | 2021 | Como criar ofertas irresistíveis — elemento #1 |
+| **Building a StoryBrand** | Donald Miller | 2017 | Framework de messaging para ads e landing pages |
+| **Contagious** | Jonah Berger | 2013 | Por que coisas viralizam — aplicável a criativos |

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/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 |