sinapse-ai 1.0.0

package/squad-growth/tasks/plan-experimentation-roadmap.md

@@ -0,0 +1,99 @@
+---
+task: plan-experimentation-roadmap
+responsavel: "@ga-orchestrator"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Plan Experimentation Roadmap
+
+## Metadata
+- **Squad:** squad-growth
+- **Agent:** Catalyst (ga-orchestrator)
+- **Complexity:** Standard
+
+## Objetivo
+Planejar roadmap de experimentacao — definir cadencia de testes, alocacao de resources, prioridades por quarter e meta de velocity de experimentacao.
+
+## Entrada
+- Growth brief and OKRs
+- Hypothesis backlog
+- Team capacity
+- Tool availability
+
+## Passos
+
+### 1. Experimentation Velocity Target
+| Metrica | Current | Target Q1 | Target Q2 | Target Mature |
+|---------|---------|----------|----------|-------------|
+| Experiments/month | | 2-4 | 4-8 | 8-12 |
+| Avg duration (weeks) | | 2-4 | 2-3 | 1-2 |
+| Win rate | | 20-30% | 25-35% | 30-40% |
+| Ideas in backlog | | 20+ | 30+ | 50+ |
+
+### 2. Quarterly Themes
+| Quarter | Theme | Focus Area | Key Experiments |
+|---------|-------|-----------|----------------|
+| Q1 | Foundation | Instrumentation + first tests | Tracking, baseline, 2-4 experiments |
+| Q2 | Optimization | CRO + SEO | Landing pages, funnels, 4-8 experiments |
+| Q3 | Growth | Activation + retention | Onboarding, hooks, 6-10 experiments |
+| Q4 | Scale | Viral + automation | Referral, ML-driven, 8-12 experiments |
+
+### 3. Resource Allocation
+| Resource | % Time | Focus |
+|----------|--------|-------|
+| Signal (Analytics) | 20% | Experiment tracking setup |
+| Convert (CRO) | 40% | Experiment design + analysis |
+| Insight (Data) | 20% | Deep analysis, segmentation |
+| Lever (Growth) | 15% | Growth mechanism testing |
+| Pulse (Campaigns) | 5% | Campaign experiments |
+
+### 4. Experiment Prioritization Process
+| Step | Action |
+|------|--------|
+| 1 | Collect ideas from all sources (data, qualitative, competitors) |
+| 2 | Score with ICE framework (1-10 each) |
+| 3 | Rank by ICE score |
+| 4 | Check for test conflicts (audience overlap) |
+| 5 | Assign to sprint (max 2-3 concurrent tests) |
+| 6 | Execute, analyze, document |
+
+### 5. Review Cadence
+| Cadencia | Atividade |
+|----------|----------|
+| Weekly | Experiment status review (15 min) |
+| Bi-weekly | Results review + next sprint planning |
+| Monthly | Velocity report + roadmap adjustment |
+| Quarterly | Strategy review + next quarter planning |
+
+## Saida
+- Experimentation roadmap by quarter
+- Velocity targets
+- Resource allocation plan
+- Prioritization process
+- Review cadence
+
+## Validacao
+- [ ] Velocity targets definidos
+- [ ] Quarterly themes alinhados com OKRs
+- [ ] Resources alocados
+- [ ] Prioritization process documentado
+- [ ] Review cadence estabelecido

package/squad-growth/tasks/research-keyword-strategy.md

@@ -0,0 +1,101 @@
+---
+task: research-keyword-strategy
+responsavel: "@ga-seo-strategist"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Research Keyword Strategy
+
+## Metadata
+- **Squad:** squad-growth
+- **Agent:** Rank (ga-seo-strategist)
+- **Complexity:** Complex
+
+## Objetivo
+Pesquisar e definir estrategia de keywords — mapear intencoes de busca, volume, dificuldade e oportunidades para guiar criacao de conteudo e otimizacao on-page.
+
+## Entrada
+- Business offerings/services
+- Target audience
+- Competitor domains
+- Current rankings (Search Console)
+
+## Passos
+
+### 1. Keyword Research Process
+| Fase | Acao | Tool |
+|------|------|------|
+| Seed keywords | Brainstorm + competitor analysis | Ahrefs, Semrush |
+| Expansion | Related terms, questions, long-tail | Ahrefs, AlsoAsked |
+| Intent mapping | Classify by search intent | Manual + SERP analysis |
+| Volume & difficulty | Assess volume and KD | Ahrefs, Semrush |
+| Opportunity scoring | Gap analysis vs competitors | Ahrefs Content Gap |
+| Prioritization | Score by opportunity × feasibility | Custom framework |
+
+### 2. Search Intent Classification
+| Intent | Descricao | SERP Features | Content Type |
+|--------|----------|--------------|-------------|
+| Informational | Aprender, entender | Featured snippets, PAA | Blog, guides, tutorials |
+| Navigational | Encontrar site/marca | Brand results, sitelinks | Homepage, brand pages |
+| Commercial | Comparar, avaliar | Reviews, comparisons | Comparison, reviews |
+| Transactional | Comprar, contratar | Shopping, ads, CTAs | Product, pricing, signup |
+
+### 3. Keyword Map Template
+| Keyword | Volume | KD | Intent | Current Rank | Target Page | Priority |
+|---------|--------|-----|--------|-------------|------------|---------|
+| | Monthly | 0-100 | I/N/C/T | Position or N/A | URL or "Create" | P1-P4 |
+
+### 4. Competitor Gap Analysis
+| Keyword | Competitor A Rank | Competitor B Rank | Our Rank | Opportunity |
+|---------|-----------------|-----------------|---------|-------------|
+| | | | | High/Medium/Low |
+
+### 5. Keyword Grouping Strategy
+| Topic Cluster | Pillar Page | Cluster Keywords | Content Pieces |
+|-------------|------------|-----------------|---------------|
+| {Main topic} | /topic/pillar-page | 15-25 related keywords | Blog posts, guides |
+
+### 6. Prioritization Framework
+| Factor | Weight | Score 1-5 |
+|--------|--------|----------|
+| Search volume | 25% | |
+| Business relevance | 30% | |
+| Ranking feasibility (KD) | 20% | |
+| Content gap (no existing page) | 15% | |
+| Conversion potential | 10% | |
+
+## Saida
+- Keyword strategy document
+- Keyword map with 100+ keywords
+- Intent classification
+- Competitor gap analysis
+- Topic cluster recommendations
+- Prioritized keyword list
+
+## Validacao
+- [ ] 100+ keywords pesquisados
+- [ ] Intent classificado para cada keyword
+- [ ] Volume e KD documentados
+- [ ] Competitor gap analysis completo
+- [ ] Keywords agrupados em clusters
+- [ ] Top 20 keywords priorizados
+- [ ] Handoff para squad-content

package/squad-growth/tasks/segment-user-behavior.md

@@ -0,0 +1,170 @@
+---
+task: segment-user-behavior
+responsavel: "@ga-data-analyst"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Segment User Behavior
+
+## Metadata
+- **Squad:** squad-growth
+- **Agent:** Insight (ga-data-analyst)
+- **Complexity:** Standard
+
+## Objetivo
+Segmentar comportamento de usuarios — criar segmentos comportamentais baseados em padroes de uso, engajamento e valor para personalizar experiencias e otimizar estrategias de growth.
+
+## Entrada
+- User event data (sessions, events, features used)
+- Transaction/revenue data
+- User attributes (demographics, firmographics)
+- Product interaction data
+
+## Passos
+
+### 1. Segmentation Frameworks
+| Framework | Base | Dimensoes | Melhor Para |
+|-----------|------|----------|------------|
+| Behavioral | Acoes no produto | Features, frequency, depth | Product teams |
+| Value-based | Revenue/LTV | Spend, potential, growth | Revenue teams |
+| Engagement | Nivel de uso | DAU/MAU, session depth, breadth | Retention teams |
+| Lifecycle | Estagio do usuario | New, active, at-risk, churned | Marketing teams |
+| Needs-based | Jobs-to-be-done | Use cases, goals | Product strategy |
+| Technographic | Stack/platform | Device, browser, integrations | Engineering |
+
+### 2. Behavioral Segmentation Dimensions
+| Dimensao | Metricas | Segmentos Tipicos |
+|----------|---------|------------------|
+| Usage frequency | Sessions/week | Power (7+), Regular (3-6), Light (1-2), Dormant (0) |
+| Feature breadth | Distinct features used | Broad (80%+), Moderate (40-79%), Narrow (< 40%) |
+| Session depth | Events per session, time | Deep (15+ min), Normal (5-14), Shallow (< 5) |
+| Content consumption | Pages, downloads, reads | Consumer, Browser, Skipper |
+| Social behavior | Shares, invites, comments | Evangelists, Participants, Lurkers |
+| Monetization | Purchases, plan tier | Premium, Standard, Free, Trial |
+
+### 3. Engagement Scoring Model
+| Acao | Peso | Exemplo |
+|------|------|---------|
+| Login | 1 | Cada login no periodo |
+| Core feature use | 3 | Usar funcionalidade principal |
+| Content creation | 5 | Criar/publicar conteudo |
+| Social interaction | 2 | Comentar, compartilhar |
+| Integration setup | 4 | Conectar ferramentas externas |
+| Upgrade/purchase | 5 | Transacao financeira |
+| Invite sent | 4 | Convidar outro usuario |
+| Support contact | -1 | Ticket de suporte (friction) |
+
+```
+Engagement Score = Sum(action_weight × action_count) / days_active
+```
+
+### 4. SQL Implementation
+```sql
+-- Behavioral user segmentation
+WITH user_behavior AS (
+  SELECT
+    user_id,
+    -- Usage frequency
+    COUNT(DISTINCT event_date) AS active_days_30d,
+    COUNT(DISTINCT DATE_TRUNC('week', event_date)) AS active_weeks,
+    -- Feature breadth
+    COUNT(DISTINCT event_name) AS features_used,
+    (SELECT COUNT(DISTINCT event_name) FROM events) AS total_features,
+    -- Session depth
+    COUNT(*) AS total_events,
+    AVG(session_duration) AS avg_session_seconds,
+    -- Value
+    SUM(CASE WHEN event_name = 'purchase' THEN event_value ELSE 0 END) AS total_spend,
+    -- Recency
+    DATE_DIFF('day', MAX(event_date), CURRENT_DATE) AS days_since_last
+  FROM events
+  WHERE event_date >= CURRENT_DATE - 30
+  GROUP BY user_id
+),
+segments AS (
+  SELECT
+    user_id,
+    active_days_30d,
+    features_used,
+    total_events,
+    avg_session_seconds,
+    total_spend,
+    days_since_last,
+    -- Frequency segment
+    CASE
+      WHEN active_days_30d >= 20 THEN 'Power User'
+      WHEN active_days_30d >= 10 THEN 'Regular'
+      WHEN active_days_30d >= 3 THEN 'Light'
+      ELSE 'Dormant'
+    END AS frequency_segment,
+    -- Feature breadth segment
+    CASE
+      WHEN features_used::FLOAT / total_features >= 0.8 THEN 'Explorer'
+      WHEN features_used::FLOAT / total_features >= 0.4 THEN 'Focused'
+      ELSE 'Single-Feature'
+    END AS breadth_segment,
+    -- Value segment
+    CASE
+      WHEN total_spend >= PERCENTILE_CONT(0.9) WITHIN GROUP (ORDER BY total_spend) OVER () THEN 'High Value'
+      WHEN total_spend >= PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY total_spend) OVER () THEN 'Mid Value'
+      WHEN total_spend > 0 THEN 'Low Value'
+      ELSE 'Non-Paying'
+    END AS value_segment
+  FROM user_behavior
+)
+SELECT * FROM segments;
+```
+
+### 5. Segment Personas
+| Persona | Freq | Breadth | Value | % Base | Strategy |
+|---------|------|---------|-------|--------|----------|
+| Power Champions | Power | Explorer | High | 5% | Advocate program, beta access |
+| Engaged Regulars | Regular | Focused | Mid | 20% | Feature education, upsell |
+| Casual Users | Light | Single | Low | 30% | Activation campaigns |
+| High-Value Narrow | Regular | Single | High | 10% | Feature discovery |
+| At-Risk Power | Dormant | Explorer | High | 5% | Urgente win-back |
+| Free Explorers | Light | Explorer | Non | 15% | Conversion offers |
+| Dormant | Dormant | Single | Non | 15% | Re-engagement or sunset |
+
+### 6. Segmentation Activation
+| Canal | Uso | Ferramenta |
+|-------|-----|-----------|
+| Email | Campaigns segmentadas por behavior | ESP (Mailchimp, Brevo) |
+| In-app | Mensagens contextuais por segmento | Product tours (Appcues, Userflow) |
+| Ads | Custom audiences por segmento | Meta, Google Ads |
+| Support | Prioridade por valor | CRM (HubSpot, Zendesk) |
+| Product | Feature gating por segmento | Feature flags (LaunchDarkly) |
+
+## Saida
+- Behavioral segmentation model
+- Segment definitions com criterios
+- User distribution por segmento
+- Strategy per segment
+- Activation plan por canal
+
+## Validacao
+- [ ] Framework de segmentacao definido
+- [ ] Scoring model calibrado
+- [ ] Segmentos mutuamente exclusivos
+- [ ] Distribuicao validada (nenhum segmento > 40%)
+- [ ] Estrategia por segmento documentada
+- [ ] Ativacao em pelo menos 2 canais planejada

package/squad-growth/tasks/select-growth-workflow.md

@@ -0,0 +1,84 @@
+---
+task: select-growth-workflow
+responsavel: "@ga-orchestrator"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Select Growth Workflow
+
+## Metadata
+- **Squad:** squad-growth
+- **Agent:** Catalyst (ga-orchestrator)
+- **Complexity:** Standard
+
+## Objetivo
+Selecionar o workflow de growth adequado — com base na maturidade de analytics, objetivos e contexto, determinar qual fluxo de trabalho otimiza resultados.
+
+## Entrada
+- Analytics maturity level (0-4)
+- Growth brief
+- Business priorities
+- Timeline constraints
+
+## Passos
+
+### 1. Workflow Selection Matrix
+| Situacao | Workflow | Agentes Primarios |
+|----------|---------|-------------------|
+| Sem tracking | Analytics Instrumentation Pipeline | Signal |
+| Tracking OK, sem otimizacao | Full Growth Analytics Cycle | All |
+| Conversao baixa | CRO Experimentation Sprint | Convert + Insight |
+| SEO fraco | SEO Audit & Optimization Cycle | Rank |
+| Growth estagnado | Growth Experiment Loop | Lever + Convert |
+| Campanhas sem medicao | Campaign Performance Review | Pulse + Insight |
+
+### 2. Criterios de Selecao
+| Criterio | Peso | Avaliacao |
+|----------|------|----------|
+| Maturity alignment | 30% | Workflow compativel com nivel atual? |
+| Business impact | 25% | Maior impacto potencial no curto prazo? |
+| Data readiness | 20% | Dados suficientes para executar? |
+| Resource fit | 15% | Time e ferramentas disponiveis? |
+| Time to results | 10% | Prazo compativel com expectativas? |
+
+### 3. Workflow Combinations
+| Cenario | Combinacao Recomendada |
+|---------|----------------------|
+| Greenfield | Instrumentation → Full Cycle |
+| Quick win | CRO Sprint (2-4 semanas) |
+| Organic growth | SEO Cycle + Content loop |
+| Paid optimization | Campaign Review + CRO Sprint |
+| Product-led growth | Growth Experiment Loop |
+| Comprehensive | Full Growth Analytics Cycle |
+
+## Saida
+- Selected workflow(s)
+- Justification document
+- Timeline estimate
+- Agent allocation plan
+
+## Validacao
+- [ ] Workflow alinhado com maturity level
+- [ ] Justificativa documentada
+- [ ] Timeline definido
+- [ ] Agentes alocados
+- [ ] Dependencias identificadas

package/squad-growth/tasks/setup-campaign-tracking.md

@@ -0,0 +1,175 @@
+---
+task: setup-campaign-tracking
+responsavel: "@ga-campaign-analyst"
+responsavel_type: Agent
+atomic_layer: Task
+elicit: false
+
+Entrada:
+  - campo: context
+    tipo: object
+    origem: "workflow ou manual"
+    obrigatorio: true
+
+Saida:
+  - campo: resultado
+    tipo: document
+    destino: "stakeholders"
+
+Checklist:
+  - "[ ] Validar inputs e pre-condicoes"
+  - "[ ] Executar steps conforme documentado"
+  - "[ ] Verificar criterios de qualidade"
+  - "[ ] Gerar output no formato especificado"
+---
+
+# Task: Setup Campaign Tracking
+
+## Metadata
+- **Squad:** squad-growth
+- **Agent:** Pulse (ga-campaign-analyst)
+- **Complexity:** Standard
+
+## Objetivo
+Configurar tracking de campanhas — implementar rastreamento end-to-end de campanhas de marketing, desde impressao ate conversao, integrando dados de plataformas de ads com analytics.
+
+## Entrada
+- Active advertising platforms
+- Conversion events defined
+- UTM strategy document
+- Analytics setup (GA4/GTM)
+
+## Passos
+
+### 1. Tracking Architecture
+```
+Ad Platforms (Impressions, Clicks, Spend)
+    │
+    ▼
+Landing Page (UTM capture, pageview)
+    │
+    ▼
+GTM Data Layer (user, session, campaign data)
+    │
+    ├──► GA4 (behavior, conversions)
+    ├──► Meta Pixel / CAPI (Meta conversions)
+    ├──► Google Ads Tag (Google conversions)
+    ├──► LinkedIn Insight Tag (LinkedIn conversions)
+    └──► Data Warehouse (unified view)
+```
+
+### 2. Platform-Specific Setup
+| Plataforma | Pixel/Tag | Server-Side | Conversions |
+|-----------|----------|-------------|------------|
+| Google Ads | Google Ads Tag via GTM | Enhanced conversions | Import from GA4 or direct |
+| Meta (FB/IG) | Meta Pixel via GTM | Conversions API (CAPI) | Standard + custom events |
+| LinkedIn | Insight Tag via GTM | CAPI (beta) | URL-based + event-based |
+| TikTok | TikTok Pixel via GTM | Events API | Standard + custom events |
+| Twitter/X | Twitter Pixel via GTM | CAPI | URL-based + event-based |
+
+### 3. GTM Tag Configuration
+| Tag | Trigger | Dados Enviados |
+|-----|---------|---------------|
+| GA4 Config | All Pages | page_view, user properties |
+| GA4 Event: conversion | Form submit / Purchase | event params, value |
+| Google Ads Conversion | Thank you page / Purchase | conversion_id, value, currency |
+| Meta Pixel: PageView | All Pages | — |
+| Meta Pixel: Purchase | Purchase event | value, currency, content_ids |
+| LinkedIn: Conversion | Form submit | conversion_id |
+
+### 4. Enhanced Conversions Setup
+| Plataforma | Dados First-Party | Implementacao |
+|-----------|------------------|-------------|
+| Google Ads | Email (hashed), phone, address | Enhanced conversions in GTM |
+| Meta CAPI | Email (hashed), phone, fbp, fbc | Server-side GTM or direct API |
+| LinkedIn | Email (hashed) | CAPI integration |
+
+**GTM Server-Side Container:**
+```
+Client-Side GTM → Server-Side GTM → Ad Platform APIs
+                                   → GA4
+                                   → Data Warehouse
+
+Benefits:
+- First-party context (bypasses ad blockers)
+- Data control (PII handling)
+- Improved data quality (95-99% accuracy)
+```
+
+### 5. Conversion Tracking Matrix
+| Conversao | GA4 Event | Google Ads | Meta | LinkedIn |
+|----------|----------|-----------|------|---------|
+| Page View | page_view | — | PageView | — |
+| Lead (form) | generate_lead | Lead | Lead | Lead |
+| Signup | sign_up | Signup | CompleteRegistration | — |
+| Add to Cart | add_to_cart | Add to Cart | AddToCart | — |
+| Purchase | purchase | Purchase | Purchase | — |
+| Contact | contact_form | Lead | Contact | Lead |
+
+### 6. Data Layer Events for Campaigns
+```javascript
+// Lead generation event
+dataLayer.push({
+  event: 'generate_lead',
+  lead_source: 'landing_page',
+  lead_type: 'demo_request',
+  form_name: 'demo_form_hero',
+  value: 150,  // estimated lead value
+  currency: 'BRL'
+});
+
+// Purchase event with campaign context
+dataLayer.push({
+  event: 'purchase',
+  ecommerce: {
+    transaction_id: 'TXN-12345',
+    value: 299.90,
+    currency: 'BRL',
+    coupon: 'BLACKFRIDAY30',
+    items: [
+      {
+        item_id: 'SKU-001',
+        item_name: 'Product Name',
+        price: 299.90,
+        quantity: 1
+      }
+    ]
+  }
+});
+```
+
+### 7. Cross-Platform Deduplication
+| Desafio | Solucao |
+|---------|---------|
+| Same conversion counted by multiple pixels | Use single source of truth (GA4 or backend) |
+| Conversion window differences | Standardize: 7-day click, 1-day view |
+| Self-reported vs independent | Compare platform data with GA4 |
+| Offline conversions | Upload offline conversion data to platforms |
+
+### 8. Campaign Tracking QA Checklist
+| Check | Ferramenta | Criterio |
+|-------|-----------|---------|
+| UTMs correct in ads | Manual review | All active ads have UTMs |
+| Pixels firing | Tag Assistant, Meta Pixel Helper | All events firing correctly |
+| Data layer populated | GTM Preview mode | Required fields present |
+| Conversions matching | Platform vs GA4 comparison | < 10% discrepancy |
+| Server-side events | Server GTM logs | Events reaching platforms |
+| Cross-domain working | GA4 debug mode | Session maintained across domains |
+| Consent integration | Consent banner test | Tags respect consent state |
+
+## Saida
+- Tracking architecture diagram
+- Platform-specific tag configurations
+- Conversion tracking matrix
+- Data layer event specifications
+- QA checklist results
+- Cross-platform deduplication strategy
+
+## Validacao
+- [ ] Tracking architecture documentada
+- [ ] Tags configurados em GTM para cada plataforma
+- [ ] Conversion events mapeados cross-platform
+- [ ] Enhanced conversions implementados
+- [ ] Data layer events especificados
+- [ ] QA executado com todos checks passing
+- [ ] Deduplication strategy definida