sinapse-ai 9.3.0 → 9.5.0

package/squads/squad-copy/knowledge-base/ai-copy-production.md

@@ -0,0 +1,254 @@
+# AI Copy Production
+
+> Fonte primaria: MS-008 (secao 11) — AI Content Production.
+> Frameworks e workflows para producao de copy com assistencia de IA.
+> Principio central: IA acelera, humano aperfecoa.
+
+---
+
+## 1. Posicionamento Correto de IA em Copy
+
+### O Que IA Faz Bem
+| Tarefa | Qualidade | Necessidade de Revisao |
+|--------|-----------|----------------------|
+| Brainstorm de angulos e hooks | Excelente | Leve (curadoria) |
+| Variacoes de headline (10-25 options) | Muito bom | Leve (selecao) |
+| Rascunho de estrutura/outline | Excelente | Leve |
+| Subject lines de email (variacoes) | Muito bom | Leve (A/B test) |
+| Variacoes de CTA | Bom | Moderada |
+| Social media copy | Bom | Moderada (tom, contexto) |
+| Traducao e adaptacao PT-BR | Muito bom | Moderada (nuances culturais) |
+| Edicao e reescrita | Excelente | Leve |
+| SEO optimization (keywords, headings, meta) | Muito bom | Leve |
+| Rascunho de body copy | Bom | Substancial (voz, fatos, originalidade) |
+| Conteudo tecnico especializado | Variavel | Substancial |
+
+### O Que IA NAO Faz (Onde Humano e Insubstituivel)
+| Elemento | Por que IA Falha |
+|----------|-----------------|
+| Experiencia de primeira mao | IA nao viveu, nao testou, nao errou — copy de "eu fiz isso" e falso |
+| Opiniao genuinamente controversa | IA tende ao consenso e meio-termo |
+| Contexto cultural local (Brasil) | Nuances de gírias, regionalismos, referencias culturais escapam |
+| Emocao autentica | IA simula emocao — leitores experientes percebem |
+| Julgamento editorial (o que NAO incluir) | O que cortar e tao importante quanto o que escrever |
+| Checagem de fatos | IA alucina — NUNCA confiar em dados sem verificacao |
+
+---
+
+## 2. Framework CRAFT — Prompt Engineering para Copy
+
+Framework padrao para construir prompts de copy com LLMs.
+Fonte: MS-008, secao 11.5.
+
+```
+C — Context: Quem voce e, para quem esta escrevendo, qual o canal
+R — Role: Que papel a IA deve assumir (copywriter, editor, estrategista)
+A — Action: O que exatamente precisa ser feito
+F — Format: Formato desejado (email, headline list, social post, landing page section)
+T — Tone: Tom de voz desejado com exemplos de referencia
+```
+
+### Template de Prompt CRAFT
+
+```
+[CONTEXT]
+Sou [seu cargo] de [tipo de empresa].
+Meu produto/servico: [descricao em 1-2 frases].
+Meu publico: [persona especifica — cargo, situacao, dor].
+Canal: [email / landing page / ad / social post].
+
+[ROLE]
+Voce e um copywriter senior especializado em [nicho/formato].
+Seu estilo de referencia: [mencionar autor/marca como referencia de tom].
+
+[ACTION]
+Crie [o que precisa] para [objetivo especifico].
+
+[FORMAT]
+Formato desejado: [lista numerada / paragrafo / estrutura especifica].
+Extensao: [N palavras / N opcoes / N variacoes].
+Restricoes: [nao mencionar X / sempre incluir Y / evitar Z].
+
+[TONE]
+Tom: [profissional mas acessivel / urgente mas nao agressivo / etc].
+Exemplos de referencia de tom: [inserir 1-2 exemplos que voce aprovou].
+```
+
+### Exemplo Real de Prompt CRAFT
+
+```
+CONTEXT: Sou head de marketing de um SaaS B2B de gestao financeira para PMEs.
+Produto: plataforma que automatiza conciliacoes bancarias e fechamento contabil.
+Publico: CFOs e controllers de empresas 50-500 funcionarios, sobrecarga de planilhas.
+Canal: sequencia de 5 emails de nurturing para leads que baixaram nosso ebook.
+
+ROLE: Voce e um copywriter de email marketing com 10 anos de experiencia em B2B SaaS.
+Tom de referencia: similar ao blog da Conta Azul — profissional mas acessivel.
+
+ACTION: Escreva as subject lines + primeiras 3 frases (opening) para cada um dos 5 emails.
+Emails 1-3 sao educativos (sem venda). Email 4 introduz o produto. Email 5 e CTA direto.
+
+FORMAT:
+- 3 opcoes de subject line por email (max 50 chars cada)
+- Preview text para cada subject (max 90 chars)
+- Opening line: 2-3 frases
+
+TONE: Profissional, direto, sem jargao excessivo.
+Como um CFO experiente conversando com um colega — sem simplificar demais, mas sem enrolacao.
+```
+
+---
+
+## 3. Workflows de Copy com IA
+
+### Workflow 1: Headlines em Volume (para teste A/B)
+```
+1. [HUMANO] Define: produto, promessa principal, avatar, canal
+2. [IA] Gera 25 headlines usando diferentes formulas (CRAFT prompt)
+3. [HUMANO] Seleciona 5-8 melhores, descarta o resto
+4. [IA] Expande e refina as selecionadas (mais especificidade, mais urgencia, etc)
+5. [HUMANO] Escolhe top 3-5 para teste
+6. [A/B TEST] Valida com dados reais
+```
+
+### Workflow 2: Email de Alta Conversao
+```
+1. [HUMANO] Define: objetivo, audience awareness level, oferta, urgencia real
+2. [IA] Brainstorm de angulos e abordagens (3-5 opcoes de approach)
+3. [HUMANO] Escolhe o angulo mais alinhado
+4. [IA] Gera rascunho completo (subject, preview, opening, body, CTA, PS)
+5. [HUMANO] Reescreve com voz propria, adiciona detalhes pessoais/dados especificos
+6. [IA] Versao editada passa por revisao de clareza e readability
+7. [HUMANO] Aprovacao final e envio
+```
+
+### Workflow 3: Landing Page Section por Section
+```
+1. [HUMANO] Define wireframe da page + awareness level do trafego
+2. Para cada secao:
+   a. [IA] Gera 2-3 versoes de copy para a secao
+   b. [HUMANO] Seleciona e reescreve com especificidades do produto real
+3. [IA] Revisao de coerencia entre secoes
+4. [HUMANO] Leitura completa — garante que e uma narrativa, nao secoes soltas
+5. [IA] Versao final passa por checklist de copy (headlines, CTAs, prova, objecoes)
+```
+
+### Workflow 4: Repurposing de Conteudo
+```
+1. [HUMANO] Fornece o conteudo original (blog post, podcast transcript, etc)
+2. [IA] Gera versoes para diferentes canais:
+   - 3 posts de LinkedIn com diferentes angulos
+   - 5 tweets/X posts extraindo insights
+   - 1 thread completa
+   - Subject line + email resumo
+   - 3 hooks para short-form video
+3. [HUMANO] Adapta ton por plataforma, adiciona contexto, aprova
+```
+
+---
+
+## 4. Prompts Especializados por Formato
+
+### Prompt para Variacoes de Headline (Ad Copy)
+```
+Produto: [X]
+Beneficio principal: [Y]
+Avatar: [Z]
+Canal: Meta Ads (feed)
+
+Gere 20 headlines seguindo estas formulas:
+- 5 usando PAS (problema-agitacao-solucao)
+- 5 usando curiosity gap
+- 5 usando numeros/resultado especifico
+- 5 usando before/after
+
+Cada headline < 40 caracteres. Sem pontuacao excessiva.
+```
+
+### Prompt para Subject Lines de Email
+```
+Email sobre: [topico/oferta]
+Lista: [subscribers que ja conhecem a marca / lista fria]
+Objetivo do email: [nutricao / venda / anuncio / conteudo]
+Tom da marca: [formal / conversacional / bold]
+
+Gere 15 subject lines com mix de:
+- Curiosidade (5 options)
+- Urgencia/escassez real (3 options)
+- Beneficio direto (4 options)
+- Pergunta (3 options)
+
+Cada subject < 50 chars. Evitar palavras spam-trigger.
+```
+
+### Prompt para CTA Variations
+```
+Landing page de: [produto/servico]
+Acao desejada: [compra / trial / demo / download]
+Nivel de comprometimento: [alto / medio / baixo]
+Tom: [direto / suave / urgente]
+
+Gere 10 variacoes de CTA copy para o botao principal.
+Mix de: beneficio-focused, action-focused, fear-of-missing-out.
+Cada CTA: 2-5 palavras.
+```
+
+---
+
+## 5. Verificacao de Qualidade — Checklist Pos-IA
+
+Antes de aprovar qualquer copy gerada por IA:
+
+```
+AUTENTICIDADE:
+[ ] Tem voz humana especifica (nao soa como template generico)?
+[ ] Inclui detalhes reais (numeros, nomes, casos especificos)?
+[ ] Evita cliches corporativos ("sinergia", "solucao robusta", "world-class")?
+
+PRECISAO:
+[ ] Todos os dados e fatos foram verificados?
+[ ] Nenhuma alegacao sem prova?
+[ ] Links e referencias estao corretos?
+
+ALINHAMENTO:
+[ ] Condiz com o awareness level do publico?
+[ ] Tom esta alinhado com brand voice?
+[ ] Promessas sao reais e deliverable?
+
+COPY QUALITY:
+[ ] Headline passa no scoring matrix (3.5+)?
+[ ] CTA e especifico e tem beneficio claro?
+[ ] Uma unica ideia central? (nao 3 mensagens em uma)
+[ ] Prova social presente se necessario?
+[ ] Objecoes respondidas?
+
+TECNICO:
+[ ] Subject line < 50 chars?
+[ ] CTA < 5 palavras?
+[ ] Paragrafos < 4 linhas?
+```
+
+---
+
+## 6. Etica e Disclosure de IA em Copy
+
+### Posicionamentos (2025-2026)
+- **Google:** Nao penaliza copy gerada por IA — penaliza baixa qualidade. E-E-A-T continua sendo o criterio.
+- **Meta Ads:** Nao exige disclosure de IA em ads.
+- **Emails:** Nenhuma lei brasileira exige disclosure de IA no conteudo de emails.
+- **CONAR (Brasil):** Ainda sem regulamentacao especifica para IA em publicidade.
+
+### Recomendacao Pratica
+Use IA como ferramenta de aceleracao, sempre revise e adicione perspectiva humana real.
+A melhor copy e indistinguivel — parece escrita por um humano que se importa.
+
+### Quando Declarar Uso de IA
+- Conteudo academico ou cientifico: sim, sempre
+- Newsletters personais de criadores: transparencia e recomendada para audiencia engajada
+- Copy de produto/marketing: nao ha obrigacao, mas "human-reviewed" pode ser diferencial
+
+## Referencias
+- MS-008 Content Research (secao 11)
+- Claude AI Documentation — Anthropic
+- "Everybody Writes" — Ann Handley (principios de escrita que IA nao substitui)
+- Content Marketing Institute — AI in Content Reports (2025)

package/squads/squad-copy/knowledge-base/brazilian-copywriting-context.md

@@ -0,0 +1,242 @@
+# Brazilian Copywriting Context
+
+> Fonte primaria: MS-008 (secao 16) — Contexto Brasileiro de Conteudo.
+> Nuances, plataformas, regulacao e cultura especificas do mercado brasileiro.
+> Essencial para qualquer copy direcionada ao publico brasileiro.
+
+---
+
+## 1. O Mercado Brasileiro de Copy
+
+### Dados do Mercado (2025-2026)
+- 183 milhoes de usuarios de internet (86.2% de penetracao — DataReportal)
+- 144 milhoes de identidades em redes sociais (67.8% da populacao)
+- 3o maior consumo de video online do mundo
+- Brasileiros: 3h49min por dia em redes sociais — maior do mundo
+- Brasil: 2o maior mercado de podcasts do mundo (44% ouve semanalmente)
+- Mercado de infoprodutos: Hotmart, Kiwify, Eduzz — ecossistema exclusivo
+
+### O que Torna o Mercado BR Unico Para Copywriters
+| Aspecto | Especificidade | Impacto no Copy |
+|---------|----------------|-----------------|
+| **Idioma** | Portugues BR tem nuances proprias — "voce" vs "tu", regionalismos | Tom errado = barreira emocional imediata |
+| **WhatsApp** | Canal de conteudo, e-commerce, atendimento, newsletters | Copy para WhatsApp tem regras proprias |
+| **Infoprodutos** | Mercado massivo de cursos e conteudo digital | Copy de lancamento tem linguagem e estrutura especifica |
+| **PIX** | Facilitou microtransacoes e compras por impulso | Menor fricao na compra = copy pode ser mais direta |
+| **Sazonalidade** | Black Friday BR e a maior do ano. Carnaval, Dia das Maes | Oportunidades de copy sazonais muito definidas |
+| **Creators** | Cultura forte de creators — audiencias leais e engajadas | Social proof de influencers locais tem peso especial |
+
+---
+
+## 2. Tom e Linguagem — O Espectro Brasileiro
+
+### Os 4 Registros de Linguagem BR
+
+| Registro | Contexto | Exemplos de Copy |
+|---------- |---------|-----------------|
+| **Formal** | Docs corporativos, B2B enterprise, juridico | "Solicite sua demonstracao" |
+| **Semiformal** | Blog B2B, LinkedIn, newsletter profissional | "Descubra como otimizar" |
+| **Informal** | Redes sociais, newsletters de creators, comunidades | "Olha que coisa incrivel que eu encontrei..." |
+| **Coloquial** | TikTok, Twitter/X, memes, Gen Z | "Cara, isso aqui mudou tudo" |
+
+### Erros Comuns de Tom (especialmente IA gerando copy BR)
+- Usar portugues de Portugal ("utilizador" em vez de "usuario", "telemóvel" em vez de "celular")
+- Tom excessivamente formal para canal informal (LinkedIn informal != LinkedIn formal)
+- Traduzir expressoes do ingles literalmente ("bottom line" = linha de baixo???)
+- Formalidade fora de contexto: "sinta-se a vontade para clicar" em TikTok
+- Nao adaptar formatos: R$ vs $, DD/MM/YYYY vs MM/DD, virgula decimal vs ponto
+
+### Proximidade Como Vantagem Competitiva
+Brasileiros respondem muito bem a:
+- Tom de conversa 1:1 ("deixa eu te contar algo...")
+- Vulnerabilidade genuina do criador/marca
+- Humor contextual (nao de piada forcada)
+- Referencias culturais locais
+- Gírias que conectam sem forcar
+
+---
+
+## 3. Copy por Plataforma no Brasil
+
+### Instagram (1a rede social BR)
+- **Formato primario:** Reels (60-90s), Carrosseis, Stories
+- **Tom:** Visual, inspiracional, emocional, proximidade
+- **Hook visual:** Texto na tela nos primeiros 2 segundos
+- **Cadencia:** 1-2 Reels/dia + Stories diarios
+- **CTA:** "Link na bio", "Salva esse post", "Compartilha com alguem"
+- **Copy de carrossel:** Slide 1 = headline forte, Slides 2-9 = valor, Slide ultimo = CTA
+
+### TikTok (Gen Z + Millennials BR)
+- **Formato:** 15-180s, vertical, legendas essenciais
+- **Tom:** Autentico, trend-driven, humor contextual, rapido
+- **Hook obrigatorio:** Os primeiros 3 segundos definem tudo
+- **Nao funciona:** Tom corporativo, producao excessivamente polida (parece ad)
+- **Funciona:** Storytelling rapido, education-entertainment, desafios, trends
+
+### LinkedIn (B2B BR)
+- **Formato:** Texto longo (1.300 chars ideal), documentos PDF (carrosseis), video
+- **Tom:** Profissional mas com historia pessoal — storytelling corporativo
+- **Copy de post viral BR no LinkedIn:**
+  ```
+  [Linha 1] Hook forte — afirmacao, numero, ou pergunta
+  [Linha 2] Contexto curto — "deixa eu explicar"
+  [Expandido - visivel apos "ver mais"] Historia completa
+  [Final] Insight acionavel ou pergunta para engajamento
+  ```
+- **CTA comum:** Comentario, compartilhamento, salvar
+- **Nao funciona:** Apenas linkar para o blog sem contexto
+
+### YouTube (2o buscador BR)
+- **Posicao BR:** Top 3 em consumo de video no mundo
+- **Formato:** Long-form (10-20min) para autoridade, Shorts para discovery
+- **Hook:** Primeiros 30 segundos definem retenção
+- **SEO PT-BR:** Pesquise keywords em portugues — muitas vezes tem menos competicao
+
+### WhatsApp (canal exclusivo BR)
+- **Contexto unico:** Nao existe em outros mercados com mesmo peso
+- **Usos de copy:** Listas de transmissao, grupos, atendimento ao cliente, infoprodutos
+- **Tom:** Muito informal, conversa 1:1, nunca parece broadcast corporativo
+- **Copy de WhatsApp:**
+  - Mensagem curta, como uma conversa
+  - Emoji aceitavel e esperado
+  - Pergunta para engajar
+  - Link no final, nao no inicio
+
+---
+
+## 4. Copy para Infoprodutos (Mercado Especifico BR)
+
+O mercado brasileiro de infoprodutos (cursos, ebooks, mentorias, comunidades) e um dos maiores do mundo.
+Plataformas: Hotmart (26M usuarios, 370k+ produtos), Kiwify, Eduzz.
+
+### Linguagem do Nicho de Infoprodutos BR
+| Expressao | Contexto |
+|-----------|---------|
+| "Sair da CLT" / "Largar o emprego" | Autonomia financeira — apelo emocional forte |
+| "Renda passiva" | Monetizacao — mas cuidado com claims exagerados |
+| "Do zero ao resultado" | Progressao — de iniciante a expert |
+| "Virar o jogo" | Transformacao rapida |
+| "Método [Nome]" | Mecanismo unico nomeado — muito usado em BR |
+| "Sem precisar de [objecao]" | Remover barreira de entrada |
+
+### Estrutura de Copy de Lancamento (BR)
+O mercado brasileiro adaptou o Product Launch Formula (Jeff Walker) para o contexto local:
+
+```
+PRE-LANCAMENTO (5-7 dias):
+Email/Post 1: "Algo diferente vem ai"
+Email/Post 2: Conteudo gratuito de alto valor (sem vender)
+Email/Post 3: Conteudo gratuito #2 — aprofunda a dor/transformacao
+Email/Post 4: "Abre amanha, [hora]"
+
+LANCAMENTO (3-7 dias):
+Abertura: Oferta completa com urgencia de carrinho
+Mid-lancamento: Depoimento especifico + FAQ
+Pre-fechamento (48h antes): "Encerra em X horas"
+Fechamento: 2-3 emails/posts no ultimo dia (manha, tarde, encerramento)
+```
+
+### Claims e Compliance em Infoprodutos BR
+- CONAR: Proibido claims de resultado garantido sem ressalvas
+- "Resultados variam" obrigatorio em testimonials de resultados financeiros
+- PROCON: Pode atuar em publicidade enganosa
+- Testimonials devem ser de clientes reais — nao fabricados
+
+---
+
+## 5. Calendario Cultural Brasileiro
+
+Copy sazonalizada supera copy evergreen em datas estrategicas.
+
+| Mes | Data Chave | Oportunidade de Copy |
+|-----|-----------|---------------------|
+| Janeiro | Virada do ano, volta as aulas | "Mude tudo em [ano]", planejamento, metas |
+| Fevereiro | Carnaval | Conteudo mais leve; pausa estrategica |
+| Marco | Dia da Mulher (8) | Empoderamento, representatividade |
+| Abril | Pascoa | Conexao familiar, presentes, culinaria |
+| Maio | Dia das Maes (2o domingo) | Campanhas emocionais, presentes, agradecimento |
+| Junho | Dia dos Namorados (12), Festa Junina | Romantico + cultural — MUITO forte para copy emocional |
+| Julho | Ferias escolares | Entretenimento, aprendizado, viagens |
+| Agosto | Dia dos Pais (2o domingo) | Similar ao Dia das Maes |
+| Setembro | Independencia (7) | Empreendedorismo, patriotismo |
+| Outubro | Dia das Criancas (12), Halloween | Presentes, familia |
+| Novembro | **Black Friday** (ultima sexta) | **MAIOR oportunidade comercial do ano para copy** |
+| Novembro | Consciencia Negra (20) | Representatividade, inclusao |
+| Dezembro | Natal, Ano Novo | Emocional, retrospectiva, previsoes |
+
+### Black Friday — Copy Especifica BR
+- Brasileiros esperam descontos REAIS (nao "Black Fraude")
+- Urgencia e escassez devem ser 100% reais
+- Antecipacao de semanas tem ROI
+- "Black Week" e "Black November" sao aceitos
+- Garantia de melhor preco tem peso especial
+
+---
+
+## 6. Regulacao de Copy no Brasil
+
+### CONAR (Conselho Nacional de Autorregulamentacao Publicitaria)
+- Autorregulacao da publicidade — nao e orgao governamental
+- Processa denuncias de propaganda enganosa ou abusiva
+- Pode recomendar alteracao ou suspensao de campanha
+- Peso moral e industria — marcas respeitam
+- **Copy que evitar:** Claims absolutos sem prova, comparacao denigratoria, apelo a medo infundado
+
+### #publi — Disclosure Obrigatorio
+- Conteudo patrocinado DEVE ser identificado claramente
+- Formas aceitas: #publi, #publicidade, "Patrocinado por [Marca]"
+- Aplica para: posts, stories, videos, podcasts, newsletters
+- CONAR e PROCON podem atuar contra publi oculta
+- Instagram "parceria paga" e recomendado
+
+### LGPD (Lei Geral de Protecao de Dados)
+- Lei 13.709/2018 — em vigor desde 2020
+- Relevante para copy: formularios de captura, cookies, email marketing
+- Consentimento explicito obrigatorio para captura de dados
+- Unsubscribe facil obrigatorio em qualquer lista de email
+- Multa: ate 2% do faturamento, max R$50 milhoes por infracao
+
+---
+
+## 7. Creators Brasileiros de Referencia (Copy/Marketing)
+
+| Creator | Vertical | Plataforma Principal | O que aprender |
+|---------|---------|---------------------|----------------|
+| Erico Rocha | Marketing/Lancamentos | YouTube + Email | Lancamentos BR, JVZOO PT-BR |
+| Conrado Adolpho | Marketing Digital | YouTube | Copy no contexto de marketing 8Ps |
+| Thiago Nigro (Primo Rico) | Financas | YouTube | Copy para audiencia mass-market BR |
+| Joel Jota | Performance/Vendas | YouTube | Storytelling de persuasao BR |
+| Rafael Kiso | Analytics/SEO | LinkedIn + YouTube | Data-driven copy BR |
+| Camila Porto | Social Selling | Instagram | Copy para Instagram BR |
+
+---
+
+## 8. Quick Reference — Copy BR dos Pontos Criticos
+
+### Frases que Funcionam no Brasil
+```
+"Deixa eu te contar algo importante..."
+"Isso aqui mudou completamente a forma como..."
+"Sem enrolacao, direto ao ponto:"
+"A maioria dos [avatar] nao sabe disso, mas..."
+"Depois de [tempo/experiencia], aprendi que..."
+"E de graca. Sem pegar o cartao."
+"Pode fechar sem medo."
+```
+
+### Frases a EVITAR no Copy BR
+```
+"Maximize o ROI de suas entregas de valor" (jargao corporativo)
+"Our solution leverages..." (ingles misturado sem necessidade)
+"Agende uma call" para B2C (formal demais para o publico geral)
+"Confira!" (fraco, sem beneficio)
+"Clique aqui" (nenhuma informacao)
+Qualquer expressao que soe de Portugal ao inves de BR
+```
+
+## Referencias
+- MS-008 Content Research (secao 16) — Contexto Brasileiro
+- DataReportal — Global Digital Report 2025
+- CONAR — Codigo Brasileiro de Autorregulamentacao Publicitaria
+- LGPD — Lei 13.709/2018
+- Hotmart / Kiwify / Eduzz — plataformas de infoprodutos BR