diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 079413b..78fdd11 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -20,7 +20,7 @@ "name": "crm-ops", "source": "./crm-ops", "description": "CRM operations, sales management, leads, customers, estimates, invoices, tickets and expense tracking with Desk CRM. Backed by NotebookLM notebooks.", - "version": "1.2.0", + "version": "1.3.0", "author": { "name": "Descomplicar - Crescimento Digital", "url": "https://descomplicar.pt" @@ -80,7 +80,7 @@ "name": "marketing", "source": "./marketing", "description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by NotebookLM notebooks.", - "version": "2.0.0", + "version": "2.1.0", "author": { "name": "Descomplicar - Crescimento Digital", "url": "https://descomplicar.pt" diff --git a/crm-ops/.claude-plugin/plugin.json b/crm-ops/.claude-plugin/plugin.json index fff727f..67b9885 100644 --- a/crm-ops/.claude-plugin/plugin.json +++ b/crm-ops/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "crm-ops", "description": "CRM operations, sales management, leads, customers, estimates, invoices, tickets and expense tracking with Desk CRM. Backed by NotebookLM notebooks.", - "version": "1.2.0", + "version": "1.3.0", "author": { "name": "Descomplicar - Crescimento Digital", "url": "https://descomplicar.pt" diff --git a/crm-ops/CHANGELOG.md b/crm-ops/CHANGELOG.md index 309cad2..eb04631 100644 --- a/crm-ops/CHANGELOG.md +++ b/crm-ops/CHANGELOG.md @@ -1,5 +1,12 @@ # CHANGELOG — crm-ops +## 1.3.0 — 2026-10-17 +### Alterado +- `estrategia-marca`: alinhada com a SPEC de Estratégia de Marca v2.0 (níveis Essencial, Standard e Completo; estrutura completa de 36 capítulos com todos os elementos das estratégias já entregues; BRIEFING-LLM e validador obrigatórios na entrega). +- Fundida a antiga `marketing:brand-strategy` (rondas de briefing, níveis, erros a evitar, exemplo de persona com 20 dimensões). +### Adicionado +- `references/estrutura-completa.md`, `references/prompt-redacao-parte.md` (redação em paralelo por parte), `scripts/montar.py` (montagem + anexo de pontos a validar), `scripts/render_pdf.py` (PDF A4 com a identidade da marca), `assets/marca-descomplicar.json`. + ## 0.1.0 — 2026-06-30 ### Adicionado - Estrutura padrão (PROC-DEV-STANDARD) diff --git a/crm-ops/skills/estrategia-marca/SKILL.md b/crm-ops/skills/estrategia-marca/SKILL.md index 9785038..a663f89 100644 --- a/crm-ops/skills/estrategia-marca/SKILL.md +++ b/crm-ops/skills/estrategia-marca/SKILL.md @@ -1,174 +1,177 @@ --- name: estrategia-marca -description: Cria estratégias de marca completas seguindo a metodologia Descomplicar® (ACIDA + Framework 16Ps). Inclui fase de pesquisa de mercado com /deep-research antes do briefing. Guia a análise de público, posicionamento, Pitch Canvas, copywriting e documento final entregável. Usar quando o utilizador diz "estratégia de marca", "branding", "criar marca", "posicionamento", "16Ps", "/estrategia-marca", "análise de público", "narrativa de marca", "proposta de valor", "pitch canvas", "pain + gain", "copywriting estratégico", "identidade de marca", "pesquisa de mercado para marca", ou quando um cliente adquire o serviço EST-MRK-010. +description: Cria estratégias de marca Descomplicar® (EST-MRK-010) conforme a SPEC v2.0 (16Ps 2026, 40Ps em projetos complexos, ≥5 nichos, 20 pontos por segmento, identidade visual da marca, bloco BRIEFING-LLM) em três níveis, Essencial, Standard e Completo, do briefing ao PDF A4 validado. A versão completa (36 capítulos) junta todos os elementos de todas as estratégias já entregues. Usar quando o utilizador diz "estratégia de marca", "brand strategy", "branding", "criar marca", "posicionamento", "16Ps", "40Ps", "/estrategia-marca", "análise de público", "personas", "segmentação", "narrativa de marca", "proposta de valor", "pitch canvas", "pain + gain", "copywriting estratégico", "tom de voz", "identidade de marca", "manifesto", "versão completa da estratégia", ou quando um cliente adquire o serviço EST-MRK-010. --- # Skill: Estratégia de Marca -Guia completo para criar estratégias de marca Descomplicar® — da pesquisa de mercado ao documento final entregável. +Da pesquisa ao documento final validado e em PDF. Substitui a antiga skill +`marketing:brand-strategy` (fundida aqui a 17-10-2026). ---- +## Fonte de verdade (ler antes de escrever) -## Fluxo de trabalho (8 fases) +Standard canónico em `Cloud/Descomplicar/ACIDA/Estrategia-de-Marca/` +(caminho local: `/media/ealmeida/Dados/Cloud/Descomplicar/ACIDA/Estrategia-de-Marca/`): -### Fase 0 — Pesquisa de mercado +| Ficheiro | Para quê | +|---|---| +| `SPEC-Estrategia-de-Marca.md` (v2.0) | Decisões canónicas, níveis, critérios de completude | +| `PROC-Estrategia-de-Marca.md` (v2.0) | Fases, gates, responsáveis | +| `CONTRATO-OUTPUT-LLM.md` | Esquema do bloco `## BRIEFING-LLM` | +| `golden-example-briefing-llm.md` | Bloco BRIEFING-LLM preenchido (Descomplicar®) | +| `validador-estrategia-marca.mjs` | Gate final: `node validador-estrategia-marca.mjs [--completo]` | -Antes do briefing com o cliente, fazer pesquisa independente. Verificar primeiro se já existem ficheiros de pesquisa (ex: pasta `Pesquisas/` no projecto). +Esta skill implementa o PROC. Se algo aqui contradisser a SPEC, prevalece a SPEC. -**Se a pesquisa já existe:** ler os ficheiros relevantes e extrair síntese. +Decisões que não se regridem (SPEC §1): 16Ps com a numeração de 2026 como base; +40Ps só em projetos complexos; ≥5 nichos reais e 20 pontos por segmento; +paleta é sempre a da marca em causa (nunca a da Descomplicar® num cliente); +`## BRIEFING-LLM` como última secção; PT-PT estrito; nada inventado, o que +faltar fica `[a validar: …]` e vai para o anexo A. -**Se não existe:** usar `/deep-research` (ou `mcp__tavily__tavily_research`) com os seguintes focos: +## Níveis -1. **Mercado/sector** — dimensão, crescimento, tendências, regulação -2. **Concorrentes** — posicionamento, mensagens, pricing, pontos fracos -3. **Público** — linguagem online, canais activos, dores expressas em fóruns/reviews -4. **Oportunidades** — gaps de mercado, tendências emergentes não exploradas +| Nível | Quando | Estrutura | Modo de redação | +|---|---|---|---| +| Essencial | Produto próprio, iteração rápida | Capítulos E de `estrutura-completa.md` | Um agente, de seguida | +| Standard (default) | Cliente EST-MRK-010 | Capítulos E + S | Bloco a bloco com validação do utilizador | +| Completo | "versão completa", marca da casa, branding WOW, cliente com várias linhas de negócio | Todos os 36 capítulos e anexos | Subagentes em paralelo por parte (`prompt-redacao-parte.md`) | -Guardar síntese em `Pesquisas/sintese-mercado.md` no projecto do cliente. +Se o pedido for ambíguo, Standard. "Completa", "com todos os elementos" ou +"como a da Descomplicar" = Completo. -**Resultado esperado:** chegar ao briefing já com hipóteses validadas sobre o mercado e o público — não para impor, mas para fazer perguntas mais certeiras e poupar tempo ao cliente. +## Fases -### Fase 1 — Activação e contexto +### Fase 0. Pesquisa de mercado +Verificar se já existe pesquisa (`Pesquisas/` no projeto). Se não, usar +`/deep-research` (ou pesquisa web) sobre mercado, concorrentes, público e +oportunidades. Só fontes primárias para números (INE, Eurostat, reguladores, +associações), sempre com link. Guardar em `Pesquisas/sintese-mercado.md`. -Ao iniciar, perguntar: -- Qual o nome do cliente/marca? -- Já existe briefing ou material de partida? -- Qual o sector/indústria? -- Temos exemplos de concorrentes? +### Fase 1. Ativação e contexto +Nome da marca, sector, material existente, concorrentes conhecidos, projeto no +Desk CRM (`get_project`). Para a própria Descomplicar® ou marcas da casa, ler +também: `Cloud/Descomplicar/Planeamento/Estrategia-2026/`, o sistema de design +(`Hub/04-Stack/02.04-Sistemas/DesignSystem-Descomplicar/sistema/docs/marca.md`) +e as fichas OKF (`empresa/`, `produtos-servicos/`). -Se existir projecto no Desk CRM, verificar com `get_project` antes de prosseguir. +### Fase 2. Briefing (rondas curtas, saltar o que já se sabe) +1. Essenciais: nome, sector, o que vende, quem compra, website. +2. Contexto: problema que resolve, 2-3 concorrentes, diferenciador, material de marca, mercado geográfico. +3. Ambição: onde quer estar a 2-3 anos, nichos prioritários, enquadramento legal. +Perguntas completas em `references/perguntas-briefing.md`. -### Fase 2 — Briefing estruturado +### Fase 3. Fundamentos (P1-P4) +Problema em 3 níveis, propósito, missão, visão, valores, objetivos, posicionamento +testável, proposta de valor. `references/framework-16ps.md` (Bloco A). +Gate P4: sem declaração de posicionamento testável, não avançar. -Conduzir entrevista com as perguntas de `references/perguntas-briefing.md`. +### Fase 4. Público (P5-P7) +≥5 nichos sectoriais com 8 pontos (`references/nichos.md`; "PMEs" não é nicho), +depois os segmentos com os 20 pontos por ordem (`references/template-documento.md` §5, +exemplo em `references/exemplo-persona-20d.md`), personas nomeadas. +Gate Público: ≥5 nichos e ≥2 segmentos com os 20 pontos completos. -Organizar por blocos: -1. Negócio (problema, serviços, mercado) -2. Público-alvo (segmentos identificados) -3. Posicionamento actual vs desejado -4. Tom de voz e personalidade -5. Concorrência e diferenciação +### Fase 5. Pitch canvas +Para quem, problema, solução, resultado, porquê nós, mais a declaração de mudança no mundo. -### Fase 3 — Fundamentos estratégicos +### Fase 6. Copywriting +Questionamento estratégico (10 perguntas), Pain + Gain original e refinado, +narrativa por segmento (dor → solução → resultado), mensagem central, headlines. +`references/narrativas-copywriting.md`. -Desenvolver com o cliente: -- **Proposta de valor única** — o que nos torna únicos, diferenciais, benefícios por camada -- **Missão, Visão, Valores e Objectivos** — com exemplos de como se manifestam na prática -- **Apresentação sumária** — empresa + serviços com tabela clara -- **Posicionamento** — declaração de posicionamento testável +### Fase 7. Restante documento +Seguir a ordem de `references/estrutura-completa.md` para o nível escolhido: +identidade e expressão, oferta e preço, comunicação e canais, crescimento, +medição e roteiro. Gate Identidade Visual: paleta desta marca em hex. -Ver `references/framework-16ps.md` → Bloco A para questões orientadoras. +No nível Completo as fases 3 a 7 correm em paralelo: o orquestrador fecha as +decisões transversais e lança um subagente por parte com +`references/prompt-redacao-parte.md`. Depois lê os relatórios, alinha nomes +partilhados entre partes e retira o que não pode sair (detalhes de incidentes, +promessas sem cláusula, concorrentes nomeados em copy). -### Fase 4 — Análise de público (20 pontos por segmento) +### Fase 8. Montagem, validação e PDF +1. Escrever a introdução (resumo executivo de 1 página + "Sobre este documento": + fontes, decisões tomadas quando as fontes divergem, convenções). +2. Escrever o `## BRIEFING-LLM` (esquema do CONTRATO; partir do golden example + e trocar tudo pelos valores desta marca; coerente com o corpo). +3. Montar: `python3 scripts/montar.py --partes --intro intro.md --briefing briefing-llm.md --config marca.json --out .md [--glossario …] [--historico …]`. + Gera o anexo A com todos os `[a validar]`. +4. Validar: `node /Estrategia-de-Marca/validador-estrategia-marca.mjs .md` (acrescentar `--completo` no nível Completo). Corrigir até 0 erros. +5. PDF A4: copiar `assets/marca-descomplicar.json` para o projeto, trocar cores, + fontes, logótipo e textos pelos da marca, e correr + `python3 scripts/render_pdf.py .md .pdf --config marca.json`. +6. Verificar: abrir pelo menos a capa, o índice, uma página de texto com € e uma + tabela (`pdftoppm -r 60 -f N -l N`); o script avisa se aparecerem fontes de + recurso do sistema (Liberation/DejaVu). -**Obrigatório:** Antes dos segmentos psicográficos, identificar os nichos sectoriais relevantes para o produto. Usar `references/nichos.md` para seleccionar e analisar **pelo menos 5 nichos específicos** (ex: clínicas de saúde, imobiliárias, agências digitais — não "PMEs" como categoria vaga). Para cada nicho preencher os 8 pontos do guia de análise sectorial. Cruzar com os 20 pontos psicográficos abaixo para construir personas completas. +### Fase 9. Entrega +- Estratégia de cliente: pasta do projeto do cliente (Desk/GDrive/local), nunca + na pasta do standard. Marca da casa: `Cloud/Descomplicar/Planeamento/…` e + atualizar a ficha OKF correspondente. +- Status `rascunho-para-validacao` enquanto houver pontos no anexo A; + `aprovado` só com o validador a 0 erros e revisão do Emanuel. +- Cliente no Desk: comentar na tarefa com o caminho e a lista de pontos a validar. -Para cada segmento identificado, desenvolver os 20 pontos na seguinte ordem: +## Checklist de entrega -1. Perfil Demográfico -2. Perfil Psicográfico -3. Dores -4. Anseios -5. Desejos -6. Frustrações -7. Preocupações -8. Medos -9. Inimigos -10. Linguagem -11. Como procuram ajuda/informação/dicas -12. Canais digitais activos -13. Estilo de Decisão -14. Mudanças (que sabem necessárias) -15. Resistência à mudança -16. Objecções típicas (+ como ultrapassar) -17. Forma de gerar emoção -18. Argumentos (a que são mais sensíveis) -19. Concorrentes (que alternativas avaliam) -20. Propostas Recusadas (e porquê) +- [ ] Pesquisa de mercado com fontes (Fase 0) +- [ ] P1-P16 referidos explicitamente +- [ ] Posicionamento testável, proposta única de valor, missão, visão, valores +- [ ] ≥5 nichos (8 pontos) e segmentos com os 20 pontos (≥2 Essencial, 3-4 Standard, todos Completo) +- [ ] Pitch canvas + declaração de mudança no mundo +- [ ] Pain + Gain original e refinado, narrativa por segmento, mensagem central +- [ ] Identidade visual com paleta desta marca em hex +- [ ] KPIs com base e metas a 3/6/12 meses +- [ ] Capítulos do nível escolhido todos presentes (`estrutura-completa.md`) +- [ ] Anexo A gerado; nenhum dado inventado +- [ ] `## BRIEFING-LLM` em último, sem placeholders +- [ ] Validador a 0 erros; PDF A4 verificado visualmente -Ver `references/metodologia-acida.md` para contexto e profundidade em cada ponto. +## Erros a evitar -### Fase 5 — Pitch Canvas +- Personas genéricas sem nome nem história; segmentos vagos ("PMEs"). +- Missão e visão de modelo; SWOT vago ("boa qualidade"); headlines do tipo "soluções inovadoras". +- KPIs sem meta numérica; proposta de valor com funcionalidades em vez de benefícios; ignorar objeções. +- Números, casos, testemunhos, preços ou concorrentes sem fonte. +- Garantias de resultado ("ROI garantido") em texto para clientes sem cláusula contratual. +- Paleta da Descomplicar® na estratégia de um cliente. +- Assinatura antiga: a Descomplicar® assina "Agência de Marketing Digital" (sistema de design de 16-10-2026), não "Aceleração" nem "Crescimento Digital". +- PDF em Letter: é sempre A4. -Estrutura de 5 elementos: -- **Para quem:** segmento + problema específico -- **O problema:** dor principal na linguagem do cliente -- **A solução:** mecanismo único de resolução -- **O resultado:** transformação concreta (antes/depois + métrica) -- **Por que nós:** razão para acreditar - -Criar também a **Declaração de mudança no mundo** — frase que resume o impacto maior da marca. - -### Fase 6 — Copywriting estratégico - -Sequência obrigatória: - -1. **Questionamento estratégico** — Qual é o objectivo da comunicação? Que transformação prometemos? -2. **Pain + Gain** — formulação problema/resultado na linguagem do cliente; depois refinar com especificidades do sector -3. **Narrativa por segmento** — fórmula: Problema (dor do público) → Solução (serviços) → Resultado (benefícios concretos) -4. **Mensagem central** — 1 frase que toda a equipa sabe de cor -5. **Headlines** — por segmento (principal + secundária) - -Ver `references/narrativas-copywriting.md` para templates e exemplos reais. - -### Fase 7 — Documento final + Investimentos - -Completar as secções finais: -- **Demonstração dos serviços** — como demonstrar, preparação, follow-up -- **Investimentos prioritários** — canais, orçamento, ROI esperado -- **KPIs** — baseline + metas a 3m, 6m, 12m -- **Inventário de activos** — o que existe, estado, prioridade - -Ver `references/template-documento.md` para a estrutura completa do documento. - -**Checklist de entrega:** -- [ ] Pesquisa de mercado feita (Fase 0) -- [ ] Proposta de valor única definida -- [ ] Missão, Visão, Valores escritos -- [ ] Apresentação sumária da empresa e serviços -- [ ] Mínimo 5 nichos sectoriais analisados (8 pontos cada) — ver `references/nichos.md` -- [ ] Mínimo 2 segmentos psicográficos com 20 pontos completos -- [ ] Pitch Canvas preenchido -- [ ] Declaração de mudança no mundo -- [ ] Pain + Gain (original + refinado) -- [ ] Narrativa por segmento (Problema → Solução → Resultado) -- [ ] Mensagem central definida -- [ ] Investimentos prioritários identificados -- [ ] KPIs definidos com metas - ---- - -## Referências (carregar conforme necessário) +## Referências | Ficheiro | Quando carregar | -|----------|----------------| -| `references/metodologia-acida.md` | Fases 3-4: ACIDA, 20 pontos por segmento | -| `references/framework-16ps.md` | Fase 3: fundamentos estratégicos (Bloco A) | -| `references/perguntas-briefing.md` | Fase 2: conduzir entrevista cliente | -| `references/narrativas-copywriting.md` | Fase 6: copywriting, Pain+Gain, narrativas | -| `references/template-documento.md` | Fase 7: estrutura completa do documento | -| `references/nichos.md` | Fase 4: análise sectorial dos 10 nichos PT/EU (mínimo 5 obrigatórios) | +|---|---| +| `references/estrutura-completa.md` | Sempre: ordem canónica, níveis, mapa 16Ps → capítulos | +| `references/prompt-redacao-parte.md` | Nível Completo: contexto e tarefa de cada subagente | +| `references/perguntas-briefing.md` | Fase 2 | +| `references/framework-16ps.md` | Fase 3 | +| `references/metodologia-acida.md` | Fases 3-4 | +| `references/nichos.md` | Fase 4: 10 nichos PT/UE, 8 pontos cada | +| `references/template-documento.md` | Guia de escrita de cada secção (20 pontos em detalhe, pitch canvas, KPIs, inventário) | +| `references/exemplo-persona-20d.md` | Fase 4: exemplo de segmento com as 20 dimensões | +| `references/narrativas-copywriting.md` | Fase 6 | +| `scripts/montar.py`, `scripts/render_pdf.py`, `assets/marca-descomplicar.json` | Fase 8 | ---- +Exemplos reais: `99-Arquivo/Manual-OwnCloud-Descomplicar/exemplos estrategias de marca/` +(Carritools é o mais completo dos clientes) e a Estratégia Descomplicar® v3.0 em +`Cloud/Descomplicar/Planeamento/Estrategia-2026/DESCOMPLICAR_ESTRATEGIA_MARCA_V3.md`. ## Contexto do serviço -- **Código:** EST-MRK-010 -- **Preço:** 900 EUR -- **Prazo médio:** 30h de trabalho -- **Entregáveis:** Documento estratégico completo, dashboard personas, narrativa de marca, apresentação executiva editável, guia de implementação, sessão de alinhamento com equipa -- **Suporte pós-entrega:** WhatsApp 1 mês - -Complementar com Branding WOW (BRAND-ESS/DIG/COM: 1.800–4.500 EUR) se o cliente precisar de identidade visual. - ---- +- Código EST-MRK-010 · 900€ fixo · cerca de 30 horas (catálogo, outubro de 2026). +- Entregáveis: documento estratégico, personas, narrativa, apresentação executiva editável, plano de implementação, sessão de alinhamento com a equipa, suporte por WhatsApp durante 1 mês. +- Identidade visual completa: Branding WOW (1 800€ a 4 500€). ## Healing Log -Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar. +Lido antes de executar. Acrescentar uma linha por erro corrigido. ```jsonl -{"date":"","issue":"","fix":"","source":"user|auto"} +{"date":"2026-10-17","issue":"Skill dizia-se alinhada com a SPEC (GATE-HOOK) mas não pedia o BRIEFING-LLM; a estratégia Descomplicar v3 reprovou no validador","fix":"Fase 8 obriga a escrever o BRIEFING-LLM e a correr o validador antes de entregar","source":"auto"} +{"date":"2026-10-17","issue":"Subagentes copiaram identificadores e pormenores de incidentes de segurança para a SWOT","fix":"Contrato de redação proíbe; orquestrador revê antes de montar","source":"auto"} +{"date":"2026-10-17","issue":"PDF saiu com Liberation Sans em vez das fontes da marca: woff2 subset sem € e faces de recurso na mesma família com pesos diferentes","fix":"render_pdf.py usa família de recurso separada e avisa se houver fontes do sistema no PDF","source":"auto"} +{"date":"2026-10-17","issue":"Partes escritas em paralelo usaram durações e segmentos diferentes (diagnóstico 30 vs 45 min, 5 vs 6 segmentos)","fix":"Fixar nomes partilhados no bloco 'Decisões já tomadas' antes de lançar","source":"auto"} ``` - -*Adicionar nova linha após cada erro corrigido.* diff --git a/crm-ops/skills/estrategia-marca/assets/marca-descomplicar.json b/crm-ops/skills/estrategia-marca/assets/marca-descomplicar.json new file mode 100644 index 0000000..fc15bcb --- /dev/null +++ b/crm-ops/skills/estrategia-marca/assets/marca-descomplicar.json @@ -0,0 +1,44 @@ +{ + "_nota": "Config de exemplo para render_pdf.py e montar.py. Só para estratégias DA PRÓPRIA Descomplicar®. Para clientes, copiar e trocar cores, fontes, logótipo e textos pelos da marca do cliente (SPEC C4). Caminhos absolutos do posto 'desktop'/'hp' (Hub em /media/ealmeida/Dados).", + "marca": "Descomplicar®", + "titulo_documento": "Estratégia de marca", + "rodape": "Descomplicar® · Estratégia de marca", + "capa_eyebrow": "Documento estratégico · versão 3.0", + "capa_titulo": "Estratégia
de marca", + "capa_slogan": "Criamos Resultados!", + "capa_assinatura": "Descomplicar® - Agência de Marketing Digital", + "capa_data": "outubro de 2026", + "logo_capa": "/media/ealmeida/Dados/Hub/04-Stack/02.04-Sistemas/DesignSystem-Descomplicar/sistema/assets/Logos/assinatura-vertical-white.svg", + "fonte_titulos": "Montserrat", + "fonte_texto": "Roboto", + "fallback": "'DCArrows','DCFallback',sans-serif", + "fontes": [ + {"family": "Montserrat", "src": "/media/ealmeida/Dados/Hub/04-Stack/02.04-Sistemas/DesignSystem-Descomplicar/sistema/fonts/Montserrat-latin-wght-normal.woff2"}, + {"family": "Roboto", "src": "/media/ealmeida/Dados/Hub/04-Stack/02.04-Sistemas/DesignSystem-Descomplicar/sistema/fonts/Roboto-latin-wght-normal.woff2"}, + {"family": "Roboto", "style": "italic", "src": "/media/ealmeida/Dados/Hub/04-Stack/02.04-Sistemas/DesignSystem-Descomplicar/sistema/fonts/Roboto-latin-wght-italic.woff2"}, + {"family": "DCFallback", "weight": "100 500", "src": "/media/ealmeida/Dados/Dev/SEO-Reports/public/fonts/pdf/Roboto-Regular.ttf"}, + {"family": "DCFallback", "weight": "600 900", "src": "/media/ealmeida/Dados/Dev/SEO-Reports/public/fonts/pdf/Roboto-Bold.ttf"}, + {"family": "DCArrows", "src": "/media/ealmeida/Dados/Dev/SEO-Reports/public/fonts/pdf/Montserrat-Regular.ttf", "unicode_range": "U+2190-21FF"} + ], + "cores": { + "escura": "#0e0d0b", + "clara_texto": "#f5f1e8", + "primaria": "#cc8d00", + "acento_texto": "#7a5400", + "texto": "#1a1814", + "texto_secundario": "#5c5750", + "suave": "#faf4e6", + "linha": "#e6e1d8", + "alternada": "#faf8f3", + "aviso_fundo": "#fdecc8", + "aviso_texto": "#5a3d00" + }, + "frontmatter": { + "type": "Document", + "title": "Descomplicar® · Estratégia de marca", + "codigo": "EST-MRK-010", + "version": "3.0", + "status": "rascunho-para-validacao", + "elaborado": "Descomplicar® - Agência de Marketing Digital" + } +} diff --git a/crm-ops/skills/estrategia-marca/references/estrutura-completa.md b/crm-ops/skills/estrategia-marca/references/estrutura-completa.md new file mode 100644 index 0000000..94303f0 --- /dev/null +++ b/crm-ops/skills/estrategia-marca/references/estrutura-completa.md @@ -0,0 +1,156 @@ +# Estrutura completa — Estratégia de Marca Descomplicar® (SPEC v2.0) + +Ordem canónica do documento de autoria. Junta, sem perder nenhum, todos os +elementos usados nas estratégias entregues (Carritools MCT, Espiral Sénior ESP, +Loja da Maria LJM, Sintricare SNT, Water Control WTC, Solar FV SFV), no modelo +ACIDA v3, no prompt 40Ps, na skill `brand-strategy` (40 pontos, fundida aqui) e +na Estratégia de Marca Descomplicar® v3.0 (17-10-2026), que é o exemplo de +referência do nível Completo. + +Exemplo de referência (nível Completo, 34 capítulos, 192 páginas A4; anterior a esta +estrutura, junta os 20 pontos nos caps. 9-11 e não tem capítulo de jornada): +`Cloud/Descomplicar/Planeamento/Estrategia-2026/DESCOMPLICAR_ESTRATEGIA_MARCA_V3.md` (+ `.pdf`). +Exemplo de profundidade por capítulo (cliente): `99-Arquivo/Manual-OwnCloud-Descomplicar/exemplos estrategias de marca/MCT Estratégia de Marca Carritools.md`. + +A ordem vai do contexto para a ação: perceber o mercado e a empresa, fixar os +fundamentos, conhecer o público, definir a expressão da marca, desenhar a oferta, +planear a comunicação e o crescimento, e por fim medir e implementar. + +## Níveis de profundidade + +| Nível | Quando | O que entra | Público | +|---|---|---|---| +| Essencial | Produto próprio, iteração rápida, teste de posicionamento | Cabeçalho, caps. 2-4 resumidos, 5-8, 9 (≥5 nichos), 10 (≥2 segmentos com 20 pontos), 16, 17, 20, 27, 32, anexo A, BRIEFING-LLM | 2-3 segmentos | +| Standard (default) | Cliente EST-MRK-010 | Essencial + 1, 11, 13-15, 18, 19, 21, 23, 35, 36 (resumo), anexos B e D | 3-4 segmentos, 20 pontos cada | +| Completo | Pedido "versão completa", marca da casa, branding WOW, cliente com várias linhas de negócio | Todos os capítulos e anexos abaixo | Todos os segmentos com 20 pontos + secundários e prescritores | + +Coluna "Nível" abaixo: E = Essencial, S = Standard, C = Completo. Um capítulo +marcado S entra em S e C; marcado E entra nos três. + +## Cabeçalho (todos os níveis) + +| Elemento | Conteúdo | Fonte de exemplo | +|---|---|---| +| Frontmatter | title, cliente, codigo EST-MRK-010, versao, data, elaborado ("Descomplicar® - Agência de Marketing Digital"), status `rascunho-para-validacao` / `aprovado` | template-documento | +| Capa | Marca, "Estratégia de marca", assinatura ou slogan do cliente | todos | +| Declaração de impacto | Uma frase de 10-15 palavras (a mudança no mundo) | template v3, LJM ("Alegria todo o dia"), WTC ("Cada gota conta") | +| Índice | Partes e capítulos | todos | +| Resumo executivo | Tabela de 1 página: assinatura, slogan, missão, visão, posicionamento, proposta única de valor, método, persona principal, oferta de entrada, prioridade imediata, cada um com o capítulo | v3.0 | +| Sobre este documento | Fontes usadas, decisões tomadas quando as fontes divergem, convenções (o que significa `[a validar]`) | v3.0 | + +## Parte I. Contexto (P6 Pesquisa) + +| Cap. | Título | Contém | P / 40Ps | Nível | Fonte de exemplo | +|---|---|---|---|---|---| +| 1 | Apresentação | Quem é a empresa (identidade legal, fundação, equipa, localização), histórico e evolução, como opera, serviços e produtos em resumo, estado atual | P8 resumo; Apresentação institucional | S | SNT, WTC, template v3, v3.0 | +| 2 | Enquadramento do mercado e contexto social | Contexto do sector, dimensão, tendências, mudanças sociais e tecnológicas, enquadramento legal e regulatório, cultura e comunidade do sector | P6; Possibilidades | E (resumo) / C | MCT 1.1-1.5, LJM, ESP | +| 3 | Concorrência e oportunidades de diferenciação | Tipos de concorrente e posicionamento de cada tipo, matriz comparativa, propostas recusadas e porquê, oportunidades de diferenciação com a condição para serem credíveis | P4, P6 | E (resumo) / C | MCT 1.3-1.6 | +| 4 | Análise SWOT | Forças, fraquezas, oportunidades, ameaças com evidência; cruzamento estratégico (SO, ST, WO, WT) e prioridades | P6 | E (resumo) / C | LJM | + +## Parte II. Fundamentos (P1-P4) + +| Cap. | Título | Contém | P | Nível | Fonte | +|---|---|---|---|---|---| +| 5 | Problema, causa e propósito | P1 em 3 níveis (superficial, real, raiz), a causa da marca, propósito (porquê, como, o quê), manifesto (opcional em E/S), lema interno | P1, P2 | E | WTC ("A nossa causa"), v3.0 | +| 6 | Missão, visão, valores e objetivos | Missão, visão com metas datadas, valores com comportamentos concretos ("fazemos / não fazemos"), objetivos estratégicos com indicador, base e meta | P2, P16 | E | todos | +| 7 | Posicionamento | Categoria e papel, declaração de posicionamento testável (formato clássico + 1 frase + versão oral), especialização vs. competição pelo preço, mapa de posicionamento, oportunidades | P4 | E | LJM, MCT 1.6 | +| 8 | Proposta de valor | Proposta única de valor, dores e como a marca as resolve (tabela), diferenciais, benefícios tangíveis e benefícios por camada/segmento, expectativas emocionais e racionais, USP, escada de valor | P3 | E | MCT 3, SNT, WTC | + +## Parte III. Públicos (P5-P7) + +| Cap. | Título | Contém | P | Nível | Fonte | +|---|---|---|---|---|---| +| 9 | Nichos e segmentos | ≥5 nichos sectoriais com os 8 pontos (`nichos.md`); segmentos primário, secundário e terciário; critérios de cliente ideal (obrigatórios, desejáveis, sinais de alerta); anti-persona; públicos secundários (prescritores, parceiros, talento) | P5 | E | MCT 2, WTC, SNT | +| 10 | Análise de 20 pontos por segmento | Para cada segmento, os 20 pontos por ordem (ver lista abaixo), com o ponto 16 (objeções) sempre acompanhado do tratamento | P5-P7 | E (≥2 seg.) / S (3-4) / C (todos) | template-documento §5, ESP, WTC | +| 11 | Personas e dashboard de personas | Persona principal com nome, biografia, objetivos, frustrações, comportamento digital, processo de decisão, citações típicas, mapa de empatia; personas secundárias; dashboard (uma ficha por persona) | P7 | S | 40Ps [8], v3.0 | +| 12 | Jornada e experiência do cliente | Fases da jornada (descoberta, consideração, decisão, onboarding, fidelização), pontos de contacto, emoção e fricção por fase | P9, P10 | C | brand-strategy 23b | + +Os 20 pontos (ordem fixa, cabeçalhos com estes nomes para o validador os +encontrar): Perfil demográfico · Perfil psicográfico · Dores · Anseios · Desejos · +Frustrações · Preocupações · Medos · Inimigos · Linguagem · Como procuram +ajuda/informação · Canais digitais · Estilo de decisão · Mudanças · Resistência à +mudança · Objeções (+ como ultrapassar) · Forma de gerar emoção · Argumentos · +Concorrentes · Propostas recusadas. + +## Parte IV. Identidade e expressão + +| Cap. | Título | Contém | Nível | Fonte | +|---|---|---|---|---| +| 13 | Personalidade da marca | Arquétipo, traços (é / não é), símbolo e o que representa | S | MCT 4.4 | +| 14 | Voz, tom e estilo de comunicação | Princípios de voz, tom por contexto (site, propostas, redes, suporte, crise), regras de escrita, léxico a usar e a banir, tabela "em vez de / escrever" | S | MCT 4.5-4.6, ESP "Voz da marca" | +| 15 | Narrativa e história da marca | Origem, porquê do nome, o cliente como herói, narrativa por segmento (Problema → Solução → Resultado) | S | ESP, SNT, WTC | +| 16 | Identidade visual | Paleta DESTA marca em hex (primária, secundária, neutros, proporções), tipografia, logótipo e versões, margens e mínimos, proibições, imagem, iconografia, acessibilidade. Nunca a paleta da Descomplicar® num cliente | E (obrigatório, SPEC C4) | MCT 4.7 | +| 17 | Assinaturas, slogan e mensagens-chave | Assinatura, slogan/tagline e regras de uso, mensagem central (≤10 palavras), mensagens-chave institucionais, mensagens e headlines por segmento, elevator pitch de 10/30/60 segundos | E | MCT 10, template-documento §7.4-7.5 | + +## Parte V. Oferta e venda (P8-P10, P15) + +| Cap. | Título | Contém | P | Nível | Fonte | +|---|---|---|---|---|---| +| 18 | Produtos, serviços e metodologia | Arquitetura da oferta, catálogo por área, casos de uso, metodologia de entrega, processos críticos, placement (canais de distribuição, pontos de venda, presença física e digital) | P8, P9, P10 | S | SNT "Serviços", v3.0 | +| 19 | Preço e modelo comercial | Lógica de preço, pacotes, avenças, preços de referência COM fonte, política de descontos e pagamento, garantias (só com cláusula contratual) | P15 | S | v3.0 | +| 20 | Pitch canvas | Porque é útil e como usar; declaração de impacto/compromisso; problema e resultado (Pain + Gain); solução; demonstração; aspetos únicos; relações; parcerias; pistas de futuro e tecnologia; atração de clientes; investimento; declaração de mudança no mundo | P3, P4 | E | SNT, template v3 | +| 21 | Venda consultiva e demonstração | Etapas do primeiro contacto ao fecho, diagnóstico, guião de demonstração (preparação, introdução, demonstração ao vivo, casos de uso, perguntas, follow-up), materiais de apoio, FAQ | P10 | S | WTC "Demonstração", brand-strategy 36 | + +## Parte VI. Comunicação e canais (P14) + +| Cap. | Título | Contém | Nível | Fonte | +|---|---|---|---|---| +| 22 | Objetivos de comunicação | Consciencialização, educação, envolvimento, confiança e credibilidade, conversão, retenção, diferenciação, advocacia; um indicador por objetivo | C | ESP | +| 23 | Canais | Website (função, mensagens-chave, estratégia, frequência, estrutura de menu e páginas), redes sociais por rede, email marketing, eventos e feiras, material impresso, vídeo e áudio, relações públicas, proximidade (WhatsApp, comunidade) | S | MCT 5, WTC, ESP "Estrutura do site" | +| 24 | Marketing de conteúdo e política editorial | Pilares, tipos de conteúdo, secções do blog, lista de artigos iniciais com intenção, princípios editoriais, CTA de fim de artigo | C | ESP, MCT 6.1 | +| 25 | SEO e GEO | Clusters de palavras-chave (sem volumes inventados), on-page, técnico, link building, presença em respostas de IA | C | MCT 6.2 | +| 26 | Publicidade online | Por plataforma: importância, estratégia, formatos, frequência e orçamento; diferenciação dos canais | C | MCT 7 | +| 27 | Copywriting | Questionamento estratégico (10 perguntas) respondido, Pain + Gain original e refinado, exemplos de CTA, estrutura da página de captura | E | SNT "Resumo estratégico", WTC, ESP | +| 28 | Calendário de conteúdos | Cadência por canal (diária, semanal, mensal), temas por mês ou trimestre | C | MCT 5.6 | + +## Parte VII. Crescimento (P11-P13, Projeção) + +| Cap. | Título | Contém | Nível | Fonte | +|---|---|---|---|---| +| 29 | Parcerias | Tipos (tecnológicas, distribuição, prescritores, associações, criadores de conteúdo), objetivo e critério de cada tipo | C | MCT 8, WTC | +| 30 | Expansão | Novos mercados geográficos, novos serviços ou produtos, cenários alternativos, critérios de decisão para avançar | C | LJM (Espanha, dropshipping), MCT 8.4 | +| 31 | Atração de clientes e prova social | Casos de sucesso e testemunhos (só com autorização), workshops e seminários, ofertas de entrada, presença em comunidades, programa de referência | C | WTC "Atração de clientes" | + +## Parte VIII. Medição e implementação (P12, P16) + +| Cap. | Título | Contém | Nível | Fonte | +|---|---|---|---|---| +| 32 | KPIs | Por área (site e SEO, redes, email, vendas, retenção): definição, fonte de dados, base, metas a 3/6/12 meses | E | MCT 9.1, SPEC P16 | +| 33 | Testes A/B e otimização contínua | Objetivos, variáveis, hipóteses, duração, análise | C | MCT 9.2, WTC | +| 34 | Sistema de relatórios | Semanal, mensal, trimestral: quem lê, o que contém, ferramenta | C | MCT 9.3 | +| 35 | Investimentos prioritários e inventário de ativos | Prioridades impacto/esforço, orçamento por canal, inventário de ativos de marketing (existe, estado, prioridade) | S | template-documento §9, §11 | +| 36 | Roteiro de implementação | Fases a 90 dias com entregáveis e responsáveis por papel, visão a 12 meses, recursos necessários, riscos e mitigação, notas de implementação (sessão de alinhamento, validação com clientes) | S (resumo) / C | v3.0, template-documento | + +## Anexos e secção final + +| Elemento | Contém | Nível | +|---|---|---| +| A. Pontos a validar | Lista gerada de todas as marcas `[a validar: …]`, por capítulo (o script `montar.py` gera-a) | todos | +| B. Glossário | Termos técnicos e nomes internos usados no documento | S | +| C. Complementos do sector | Enquadramento legal detalhado, informações operacionais, serviços detalhados (só quando o sector o pede) | C | +| D. Histórico de alterações | Versão, data, alteração | todos | +| `## BRIEFING-LLM` | Bloco-contrato YAML (`CONTRATO-OUTPUT-LLM.md`). **Última secção do ficheiro**, depois dos anexos | todos (obrigatório) | + +## Mapa 16Ps → capítulos + +| P | Capítulos | +|---|---| +| P1 Problema | 5 | +| P2 Propósito | 5, 6 | +| P3 Proposta de valor | 8, 20 | +| P4 Posicionamento | 3, 7 | +| P5 Público-alvo | 9, 10 | +| P6 Pesquisa | 2, 3, 4 | +| P7 Persona | 10, 11 | +| P8 Produto/serviço | 1, 18 | +| P9 Placement | 12, 18, 23 | +| P10 Processos críticos | 18, 21 | +| P11 Pessoas | 1, 36 (recursos) | +| P12 Planeamento | 28, 36 | +| P13 Parcerias | 29 | +| P14 Promoção | 22-27 | +| P15 Preço | 19 | +| P16 Performance | 6, 32-34 | + +Escrever explicitamente "(P1)", "(P2)"… nos títulos ou na primeira linha de cada +capítulo: o validador procura as referências P1-P16 no texto. diff --git a/marketing/skills/brand-strategy/references/exemplo-persona-20d.md b/crm-ops/skills/estrategia-marca/references/exemplo-persona-20d.md similarity index 100% rename from marketing/skills/brand-strategy/references/exemplo-persona-20d.md rename to crm-ops/skills/estrategia-marca/references/exemplo-persona-20d.md diff --git a/crm-ops/skills/estrategia-marca/references/prompt-redacao-parte.md b/crm-ops/skills/estrategia-marca/references/prompt-redacao-parte.md new file mode 100644 index 0000000..989a20b --- /dev/null +++ b/crm-ops/skills/estrategia-marca/references/prompt-redacao-parte.md @@ -0,0 +1,89 @@ +# Prompt de redação por parte (nível Completo) + +No nível Completo o documento tem 60 000 a 90 000 palavras. Um só agente não o +escreve com qualidade numa passagem. Divide-se por partes (I a VIII de +`estrutura-completa.md`) e entrega-se cada parte a um subagente, em paralelo. O +orquestrador fixa as decisões, junta, revê e gera o PDF. + +Divisão que funcionou (Estratégia Descomplicar® v3.0, 17-10-2026, 7 subagentes, +cerca de 15 minutos): I · II · III · IV · V · VI · VII+VIII. + +## Antes de lançar (orquestrador) + +1. Ler as fontes principais e decidir os conflitos que afetam várias partes: + assinatura e slogan, nome da categoria, garantias, lista e ordem dos + segmentos, oferta de entrada (nome e duração), formato monetário. +2. Escrever essas decisões no bloco "Decisões já tomadas" abaixo. Subagentes + não rediscutem decisões; registam divergências em "Nota de fonte". +3. Mandar os subagentes alinharem entre si os nomes partilhados (segmentos, + ofertas, canais) por mensagem direta, sem editar ficheiros alheios. + +## Contexto partilhado (copiar para o campo de contexto de todos os subagentes) + +```markdown +# Goal +Escrever a Estratégia de Marca de (, ), nível Completo. +Cada subagente escreve UMA parte; o orquestrador junta. + +# Estrutura global (contrato; numeração fixa) + + +# Fontes (ler as relevantes; NÃO inventar factos) +- Briefing e notas da entrevista: +- Pesquisa de mercado (Fase 0): /Pesquisas/sintese-mercado.md +- Material do cliente (site, catálogo, propostas, manual de marca): +- Desk CRM / OKF do cliente: +- Exemplo de profundidade: 99-Arquivo/Manual-OwnCloud-Descomplicar/exemplos estrategias de marca/MCT Estratégia de Marca Carritools.md (formato, não conteúdo) +- Dados externos: só fontes primárias (INE, Eurostat, Comissão Europeia, entidades + reguladoras, associações do sector); cada número com link numa nota no fim do capítulo. + +# Decisões já tomadas (aplicar, não rediscutir) +- Assinatura / slogan / categoria: <…> +- Segmentos (nome e ordem): <…> +- Oferta de entrada: <…> +- Garantias: só as que existem em contrato; promessas de resultado não entram em texto para clientes. +- Onde as fontes divergem, prevalece a mais recente; registar numa linha "Nota de fonte" no fim do capítulo. + +# Regras de escrita +- PT-PT, Acordo Ortográfico de 1990, zero brasileirismos (equipa, registo, ecrã, telemóvel, utilizador, planeamento). +- Copy dirigido ao cliente final em 3.ª pessoa de cortesia ("a sua empresa"); nunca "você" fora de citações. +- Títulos em frase. `## N. Título` para capítulos, `### N.M` para secções, `####` se preciso. Não escrever o título da Parte. +- Indicar o P correspondente na primeira linha do capítulo, ex.: "(P4)". +- Sem emoji, sem travessões (— ou –) como pausa, sem negrito no início de cada item de lista, sem frases-feitas ("alavancar", "no panorama atual", "não é X, é Y", perguntas retóricas respondidas logo a seguir). +- Moeda: 1 250€ (valor, espaço de milhar, símbolo colado). Datas por extenso: 16 de outubro de 2026. +- Concorrentes: no documento interno descrever por tipo; nomes só se vierem das fontes e nunca em copy ou mensagens destinadas a material público. +- Nunca inventar números, clientes, casos, preços, testemunhos ou concorrentes. Se o dado faltar, escrever o elemento na mesma e marcar `[a validar: o que falta]`. +- Casos e testemunhos de clientes só com autorização registada; sem ela, `[a validar: autorização de ]`. +- Detalhes de incidentes de segurança, credenciais e dados pessoais nunca entram no documento. +- Não repetir capítulos de outras partes: escrever "ver capítulo N". + +# Entrega +Escrever em `local://marca/parte-.md` só os capítulos atribuídos. +Não criar nem alterar mais nenhum ficheiro, não correr builds. +Resposta final: nº de palavras, lista de `[a validar]`, notas de fonte, decisões tomadas que o orquestrador deve conhecer. +``` + +## Tarefa por subagente (um por parte) + +```markdown +# Target +Parte . : capítulos a . Ficheiro: local://marca/parte-.md. + +# Change +- Cap. N: +- … + +# Acceptance +Capítulos N-M completos, cada afirmação factual rastreável a fonte interna ou a nota com link; `[a validar]` onde faltar dado. +``` + +## Depois de receber as partes (orquestrador) + +1. Ler os relatórios: decisões tomadas por cada subagente, divergências entre + partes (ex.: duração do diagnóstico, segmentos) e corrigi-las. +2. Procurar e retirar: detalhes de incidentes, caminhos de relatórios internos + sensíveis, nomes de concorrentes em copy, promessas sem cláusula. +3. Correr `scripts/montar.py` (junta, cria o anexo A) e escrever à mão a + introdução (resumo executivo e "Sobre este documento") e o `## BRIEFING-LLM`. +4. Validar e gerar o PDF (ver SKILL.md, Fase 8). diff --git a/crm-ops/skills/estrategia-marca/references/template-documento.md b/crm-ops/skills/estrategia-marca/references/template-documento.md index 4fad45d..d32ed34 100644 --- a/crm-ops/skills/estrategia-marca/references/template-documento.md +++ b/crm-ops/skills/estrategia-marca/references/template-documento.md @@ -1,7 +1,7 @@ # Template: Documento de Estratégia de Marca -Estrutura completa do documento entregável ao cliente. Baseado nos projectos SFV, LJM, MCT, Espiral Senior e Sintricare. -Adaptar secções ao sector e complexidade do cliente. +Guia de escrita de cada secção (o que escrever e com que profundidade). Baseado nos projetos SFV, LJM, MCT, Espiral Sénior e Sintricare. +A ORDEM e a numeração dos capítulos vêm de `estrutura-completa.md` (SPEC v2.0), que prevalece sobre o índice abaixo. Adaptar ao sector e ao nível (Essencial, Standard, Completo). --- @@ -14,7 +14,7 @@ cliente: [Nome do cliente] código: EST-MRK-010 versão: 1.0 data: [DD-MM-YYYY] -elaborado: Descomplicar® — Agência de Aceleração Digital +elaborado: Descomplicar® - Agência de Marketing Digital status: draft | aprovado --- ``` @@ -370,5 +370,5 @@ O Pitch Canvas é uma ferramenta de comunicação estratégica que resume, numa --- -*Elaborado por Descomplicar® — Agência de Aceleração Digital* +*Elaborado por Descomplicar® - Agência de Marketing Digital* *emanuel@descomplicar.pt | descomplicar.pt* diff --git a/crm-ops/skills/estrategia-marca/scripts/montar.py b/crm-ops/skills/estrategia-marca/scripts/montar.py new file mode 100755 index 0000000..8853736 --- /dev/null +++ b/crm-ops/skills/estrategia-marca/scripts/montar.py @@ -0,0 +1,86 @@ +#!/usr/bin/env python3 +"""Junta as partes de uma estratégia de marca num único markdown. + +Uso: + montar.py --partes DIR --intro intro.md --briefing briefing-llm.md --config marca.json --out estrategia.md + [--glossario glossario.md] [--complementos complementos.md] [--historico historico.md] + +- DIR contém parte-I.md ... parte-VIII.md (só os capítulos, `## N. Título`). +- intro.md: resumo executivo + "Sobre este documento" (títulos `# ...`). +- briefing-llm.md: a secção `## BRIEFING-LLM` completa (fica sempre em último). +- marca.json: chaves `frontmatter` (dict) e, opcional, `partes` ([[romano, nome], ...]). +Gera o anexo A (pontos a validar) a partir das marcas `[a validar: ...]`. +""" +import argparse, json, os, re, sys + +PARTES = [["I", "Contexto"], ["II", "Fundamentos da marca"], ["III", "Públicos"], + ["IV", "Identidade e expressão"], ["V", "Oferta e venda"], ["VI", "Comunicação e canais"], + ["VII", "Crescimento"], ["VIII", "Medição e implementação"]] + + +def yaml_value(v): + if isinstance(v, list): + return "[" + ", ".join(str(x) for x in v) + "]" + s = str(v) + return '"' + s.replace('"', '\\"') + '"' if re.search(r"[:#®·\-]", s) else s + + +def main(): + ap = argparse.ArgumentParser() + ap.add_argument("--partes", required=True) + ap.add_argument("--intro", required=True) + ap.add_argument("--briefing", required=True) + ap.add_argument("--config", required=True) + ap.add_argument("--out", required=True) + ap.add_argument("--glossario") + ap.add_argument("--complementos") + ap.add_argument("--historico") + a = ap.parse_args() + + cfg = json.load(open(a.config, encoding="utf-8")) + fm = "---\n" + "".join(f"{k}: {yaml_value(v)}\n" for k, v in cfg.get("frontmatter", {}).items()) + "---\n\n" + doc = [fm, open(a.intro, encoding="utf-8").read().rstrip() + "\n\n"] + + for rom, nome in cfg.get("partes", PARTES): + p = os.path.join(a.partes, f"parte-{rom}.md") + if not os.path.exists(p): + sys.exit(f"Falta {p}") + t = open(p, encoding="utf-8").read().strip() + if re.search(r"^# ", t, re.M): + sys.exit(f"{p} tem títulos de nível 1; só o montar.py escreve as Partes") + doc.append(f"# Parte {rom}. {nome}\n\n{t}\n\n") + full = "".join(doc) + + pend, cap, seen, rows = [], None, set(), [] + for line in full.split("\n"): + m = re.match(r"^## (\d+)\. ", line) + if m: + cap = int(m.group(1)) + for v in re.findall(r"\[a validar:\s*([^\]]+)\]", line): + pend.append((cap or 0, v.strip().rstrip("."))) + for c, v in pend: + if (c, v.lower()) in seen: + continue + seen.add((c, v.lower())) + rows.append(f"| {c or '—'} | {v[0].upper() + v[1:]} |") + + anexos = ["# Anexos\n\n## A. Pontos a validar\n\n", + f"{len(rows)} pontos, por capítulo. Cada ponto fechado corrige-se no capítulo e sai desta lista.\n\n", + "| Cap. | O que falta confirmar |\n| --- | --- |\n", "\n".join(rows) or "| — | Nenhum |", "\n\n"] + extras = [(t, f) for t, f in [("Glossário", a.glossario), ("Complementos do sector", a.complementos), + ("Histórico de alterações", a.historico)] if f] + for letra, (titulo, f) in zip("BCD", extras): + anexos.append(f"## {letra}. {titulo}\n\n" + open(f, encoding="utf-8").read().strip() + "\n\n") + full += "".join(anexos) + + br = open(a.briefing, encoding="utf-8").read().strip() + if not br.startswith("## BRIEFING-LLM"): + sys.exit("briefing-llm.md tem de começar por '## BRIEFING-LLM'") + full += br + "\n" + open(a.out, "w", encoding="utf-8").write(full) + caps = len(re.findall(r"^## \d+\. ", full, re.M)) + print(f"{a.out}: {len(full.split())} palavras, {caps} capítulos, {len(rows)} pontos a validar") + + +if __name__ == "__main__": + main() diff --git a/crm-ops/skills/estrategia-marca/scripts/render_pdf.py b/crm-ops/skills/estrategia-marca/scripts/render_pdf.py new file mode 100755 index 0000000..e564c97 --- /dev/null +++ b/crm-ops/skills/estrategia-marca/scripts/render_pdf.py @@ -0,0 +1,134 @@ +#!/usr/bin/env python3 +"""Estratégia de marca (markdown) -> PDF A4 com a identidade DA MARCA em causa. + +Uso: render_pdf.py estrategia.md estrategia.pdf --config marca.json [--html saida.html] + +Requer: pandoc, google-chrome (ou chromium), pdfinfo. +O marca.json define cores, fontes, logótipo e textos da capa (ver assets/marca-descomplicar.json). +Regras aprendidas (17-10-2026): +- A4 sempre (nunca Letter). Margens 20/18 mm, numeração no rodapé. +- Fontes web subset (ex.: woff2 só latim básico) não têm €, → ou −; declarar uma + família de recurso SEPARADA (`fallback` no config) e acrescentá-la a todas as pilhas. + Não usar unicode-range na mesma família com intervalos de peso diferentes: o Chrome + escolhe a face pelo peso e perde o resto dos glifos. +- Confirmar com `pdffonts` que não aparecem Liberation/DejaVu (exceto mono) e ver uma + página de conteúdo renderizada, não só a capa. +- A secção BRIEFING-LLM vai no PDF como está (bloco yaml), por ser a última secção. +""" +import argparse, json, re, shutil, subprocess, tempfile, os + +TPL = """ +$title$ + + + +$body$ + +""" + + +def face(f): + s = f"@font-face{{font-family:'{f['family']}';src:url('file://{f['src']}');" + s += f"font-weight:{f.get('weight', '100 900')};font-style:{f.get('style', 'normal')};" + if f.get("unicode_range"): + s += f"unicode-range:{f['unicode_range']};" + return s + "}" + + +def main(): + ap = argparse.ArgumentParser() + ap.add_argument("src") + ap.add_argument("out") + ap.add_argument("--config", required=True) + ap.add_argument("--html") + a = ap.parse_args() + c = json.load(open(a.config, encoding="utf-8")) + + md = open(a.src, encoding="utf-8").read() + md = re.sub(r"\A---\n.*?\n---\n", "", md, flags=re.S) + with tempfile.TemporaryDirectory() as tmp: + tpl = os.path.join(tmp, "tpl.html") + open(tpl, "w", encoding="utf-8").write(TPL) + body = subprocess.run( + ["pandoc", "-f", "gfm+attributes", "-t", "html5", "--toc", "--toc-depth=2", "--standalone", + "--template", tpl, "--metadata", f"title={c['titulo_documento']}", "--metadata", "lang=pt-PT"], + input=md, capture_output=True, text=True, check=True).stdout + + marca = c["marca"] # ex.: "Descomplicar®" + if marca.endswith("®"): + base = re.escape(marca[:-1]) + body = re.sub(rf"(?®', body) + body = re.sub(r"\[a validar:([^\]]*)\]", r'[a validar:\1]', body) + + T, X, FB = c["fonte_titulos"], c["fonte_texto"], c.get("fallback", "sans-serif") + k = c["cores"] # escura, clara_texto, primaria, acento_texto, suave, linha, alternada, aviso_fundo, aviso_texto + faces = "\n".join(face(f) for f in c.get("fontes", [])) + css = f"""{faces} +@page{{size:A4;margin:20mm 18mm 20mm 18mm; + @bottom-left{{content:"{c['rodape']}";font:8.5pt '{X}',{FB};color:{k['texto_secundario']}}} + @bottom-right{{content:counter(page);font:600 8.5pt '{T}',{FB};color:{k['acento_texto']}}}}} +@page capa{{margin:0;@bottom-left{{content:none}}@bottom-right{{content:none}}}} +html{{-webkit-print-color-adjust:exact;print-color-adjust:exact}} +body{{font-family:'{X}',{FB};font-size:10.2pt;line-height:1.55;color:{k['texto']};margin:0}} +sup.reg{{font-size:.45em;vertical-align:super;line-height:0;margin-left:.02em}} +.capa{{page:capa;height:297mm;width:210mm;background:{k['escura']};color:{k['clara_texto']};position:relative;break-after:page;box-sizing:border-box;padding:34mm 22mm}} +.capa svg,.capa img{{width:56mm;height:auto;display:block}} +.capa .eyebrow{{font:700 9pt '{T}',{FB};letter-spacing:.14em;text-transform:uppercase;color:{k['primaria']};margin-top:52mm}} +.capa h1{{font:300 40pt/1.05 '{T}',{FB};text-transform:uppercase;margin:6mm 0 8mm;color:{k['clara_texto']};border:0;padding:0;break-before:auto}} +.capa .slogan{{font:700 18pt '{T}',{FB};color:{k['primaria']}}} +.capa .meta{{position:absolute;left:22mm;right:22mm;bottom:24mm;border-top:1px solid {k['primaria']};padding-top:5mm;font-size:9.5pt;color:{k['clara_texto']};opacity:.75;display:flex;justify-content:space-between}} +nav#TOC{{break-after:page}} +nav#TOC::before{{content:"Índice";display:block;font:700 22pt '{T}',{FB};margin:0 0 6mm}} +nav#TOC ul{{list-style:none;padding-left:0;margin:0}} +nav#TOC > ul > li{{margin-top:3.2mm;font:700 10pt '{T}',{FB};color:{k['acento_texto']};text-transform:uppercase;letter-spacing:.05em}} +nav#TOC > ul > li > ul > li{{font:400 9.6pt '{X}',{FB};color:{k['texto']};text-transform:none;letter-spacing:0;padding-left:4mm;margin-top:.6mm}} +nav#TOC a{{color:inherit;text-decoration:none}} +h1{{font:300 26pt/1.1 '{T}',{FB};text-transform:uppercase;letter-spacing:.02em;break-before:page;margin:0 0 8mm;padding-bottom:4mm;border-bottom:3px solid {k['primaria']}}} +h2{{font:700 17pt/1.2 '{T}',{FB};margin:9mm 0 3mm;break-after:avoid}} +h3{{font:600 12.5pt/1.25 '{T}',{FB};margin:6mm 0 2mm;break-after:avoid}} +h4{{font:600 10.5pt '{T}',{FB};margin:4mm 0 1.5mm;break-after:avoid;color:{k['acento_texto']}}} +p{{margin:0 0 2.6mm;orphans:3;widows:3}} +ul,ol{{margin:0 0 3mm;padding-left:6mm}} li{{margin:.6mm 0}} +a{{color:{k['acento_texto']}}} +blockquote{{margin:3mm 0;padding:3mm 5mm;background:{k['suave']};border-left:4px solid {k['primaria']};font-size:10.6pt}} +blockquote p:last-child{{margin:0}} +table{{border-collapse:collapse;width:100%;margin:2mm 0 4mm;font-size:8.8pt}} +tr{{break-inside:avoid}} +th{{background:{k['escura']};color:{k['clara_texto']};font:600 8.4pt '{T}',{FB};text-align:left;padding:2mm 2.4mm}} +td{{border-bottom:1px solid {k['linha']};padding:1.8mm 2.4mm;vertical-align:top}} +tr:nth-child(even) td{{background:{k['alternada']}}} +code,pre{{font-size:8.4pt;background:{k['suave']};border-radius:2px}} +code{{padding:0 1mm}} pre{{padding:3mm;white-space:pre-wrap}} +hr{{border:0;border-top:1px solid {k['linha']};margin:5mm 0}} +.av{{background:{k['aviso_fundo']};color:{k['aviso_texto']};padding:0 1mm;border-radius:2px;font-size:.92em}} +""" + logo = "" + if c.get("logo_capa"): + logo = open(c["logo_capa"], encoding="utf-8").read() + logo = re.sub(r"<\?xml[^>]*>", "", logo) + capa = (f'
{logo}
{c["capa_eyebrow"]}
' + f'

{c["capa_titulo"]}

{c.get("capa_slogan", "")}
' + f'
{c["capa_assinatura"]}{c["capa_data"]}
') + if marca.endswith("®"): + capa = capa.replace(marca, f'{marca[:-1]}®') + html = body.replace("", f"").replace("", capa) + hp = a.html or os.path.join(tmp, "doc.html") + open(hp, "w", encoding="utf-8").write(html) + chrome = shutil.which("google-chrome") or shutil.which("google-chrome-stable") or shutil.which("chromium") + subprocess.run([chrome, "--headless=new", "--no-sandbox", "--disable-gpu", "--no-pdf-header-footer", + "--generate-pdf-document-outline", "--virtual-time-budget=20000", + f"--print-to-pdf={os.path.abspath(a.out)}", "file://" + os.path.abspath(hp)], + check=True, capture_output=True, timeout=600) + info = subprocess.run(["pdfinfo", a.out], capture_output=True, text=True).stdout + fonts = subprocess.run(["pdffonts", a.out], capture_output=True, text=True).stdout + print("\n".join(l for l in info.splitlines() if l.startswith(("Pages", "Page size")))) + bad = sorted({re.sub(r"^[A-Z]{6}\+", "", l.split()[0]) for l in fonts.splitlines()[2:] + if re.search(r"Liberation|DejaVuSans(?!Mono)|Nimbus", l)}) + if bad: + print("AVISO: fontes de recurso do sistema no PDF:", ", ".join(bad)) + + +if __name__ == "__main__": + main() diff --git a/marketing/.claude-plugin/plugin.json b/marketing/.claude-plugin/plugin.json index a792e3f..0d4739e 100644 --- a/marketing/.claude-plugin/plugin.json +++ b/marketing/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "marketing", "description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by NotebookLM notebooks.", - "version": "2.0.0", + "version": "2.1.0", "author": { "name": "Descomplicar - Crescimento Digital", "url": "https://descomplicar.pt" diff --git a/marketing/CHANGELOG.md b/marketing/CHANGELOG.md index bf3e7b4..09e3840 100644 --- a/marketing/CHANGELOG.md +++ b/marketing/CHANGELOG.md @@ -1,5 +1,9 @@ # CHANGELOG — marketing +## 2.1.0 — 2026-10-17 +### Removido +- Skill `brand-strategy`: fundida em `crm-ops:estrategia-marca` (uma só skill de estratégia de marca, alinhada com a SPEC v2.0). + ## 0.1.0 — 2026-06-30 ### Adicionado - Estrutura padrão (PROC-DEV-STANDARD) diff --git a/marketing/skills/brand-strategy/SKILL.md b/marketing/skills/brand-strategy/SKILL.md deleted file mode 100644 index 73d4a15..0000000 --- a/marketing/skills/brand-strategy/SKILL.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -name: brand-strategy -description: Gerar estrategias de marca completas seguindo o padrao de excelencia Descomplicar — metodologia ACIDA + Framework 16Ps + 20 dimensoes por persona. Usar quando "estrategia de marca", "brand strategy", "posicionamento", "proposta de valor", "personas", "segmentacao", "pitch canvas", "copywriting estrategico", "narrativa de marca", "tom de voz", "identidade de marca", "manifesto", "branding estrategico", ou qualquer documento estrategico de marca para cliente ou produto proprio. ---- - -# Estrategia de Marca Descomplicar - -Gerar documentos estrategicos de marca completos com 40 pontos em 7 blocos, usando metodologia ACIDA + Framework 16Ps. - -## Referencia obrigatoria - -Antes de gerar, ler a referencia adequada ao bloco em trabalho: -- **Metodologia e frameworks:** `references/metodologia-acida-16ps.md` -- **Estrutura do documento (40 pontos):** `references/estrutura-documento.md` -- **Exemplos de personas (20 dimensoes):** `references/exemplo-persona-20d.md` - -## Workflow - -### Fase 1 — Recolha - -Recolher informacao em rondas curtas. Nao fazer todas as perguntas de uma vez. - -**Ronda 1 — Essenciais:** -1. Nome da marca/empresa/produto -2. Sector de actividade -3. O que vende (1-2 frases) -4. Quem compra (termos gerais) -5. Website (se existir) - -**Ronda 2 — Contexto:** -6. Problema principal que resolve -7. 2-3 concorrentes directos -8. Diferenciador vs concorrentes -9. Material existente (logo, cores, docs) -10. Mercado geografico - -**Ronda 3 — Ambicao:** -11. Onde quer estar em 2-3 anos -12. Nichos/sectores prioritarios -13. Contexto legal (se sector regulado) - -Saltar perguntas ja respondidas. - -### Fase 2 — Pesquisa - -1. Pesquisar website da marca (WebFetch) -2. Pesquisar concorrentes mencionados -3. Pesquisar contexto do sector -4. Verificar contexto legal se regulado - -### Fase 3 — Geracao (bloco a bloco, conversacional) - -Gerar o documento seguindo `references/estrutura-documento.md`, mas **bloco a bloco com validacao do utilizador** entre cada bloco. Nao gerar tudo de uma vez. - -**Sequencia de trabalho (workflow original Descomplicar):** - -1. **Proposta de valor unica** — apresentar e pedir feedback -2. **Missao, Visao, Valores, Objectivos** — gerar e validar -3. **Apresentacao sumaria** — empresa + servicos -4. **Segmentos de publico** — identificar e confirmar com utilizador -5. **Personas detalhadas** — gerar 20 dimensoes por segmento (o bloco mais pesado). Apresentar 1 persona de cada vez, pedir feedback antes de avancar para a seguinte -6. **Pitch Canvas** — 5 elementos + declaracao de mudanca no mundo -7. **Pain + Gain** — por segmento, depois iterar ("reescreve tendo em conta [contexto especifico]") -8. **Demonstracao do produto/servico** — como mostrar na pratica -9. **Investimentos prioritarios** — onde colocar recursos primeiro -10. **Copywriting** — questionamento estrategico (10 perguntas) -11. **Narrativas por segmento** — formula: Dor do publico -> Solucao (servicos) -> Resultado (beneficios) -12. **Restantes blocos** (activacao, implementacao, complementos) - -**Depois de cada bloco:** perguntar "Queres ajustar alguma coisa antes de avancar?" - -**Regras de geracao:** -- PT-PT com acentos correctos -- Minimo 3 segmentos com 20 dimensoes cada (ver `references/exemplo-persona-20d.md`) -- Personas com nome e historia -- Copywriting: Pain -> Solution -> Result -- Headlines concretas (nao genericas) -- KPIs mensuraveis com baseline e meta -- Tom profissional mas acessivel -- Pain+Gain deve ser iterado — primeira versao generica, segunda versao com questoes especificas do negocio - -### Fase 4 — Compilacao e entrega - -1. Compilar todos os blocos validados num unico documento .md -2. Adicionar frontmatter (titulo, versao, data, autor, codigo EST-MRK-0XX) -3. Gravar ficheiro -4. Se cliente Desk CRM: comentar na tarefa - -## Niveis de profundidade - -| Nivel | Contexto | Blocos | Personas | -|-------|----------|--------|----------| -| **Essencial** | Produto proprio, iteracao rapida | A + B + C resumido | 3 seg, 8 dimensoes | -| **Standard** | Cliente EST-MRK-010 (900 EUR) | A + B + C + D + E | 3-4 seg, 20 dimensoes | -| **Premium** | Branding completo (1.800-4.500 EUR) | Todos (A-G) | 4+ seg, 20 dim + nichos | - -Default: Standard. Perguntar se ambiguo. - -## Erros a evitar - -- Personas genericas sem nome/historia -- Missao/visao copiadas de templates -- SWOT vago ("boa qualidade") -- Headlines tipo "Solucoes inovadoras" (sem especificidade) -- KPIs sem meta numerica -- Proposta de valor com funcionalidades em vez de beneficios -- Ignorar objecoes do publico - ---- - -## Healing Log - -Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar. - -```jsonl -{"date":"","issue":"","fix":"","source":"user|auto"} -``` - -*Adicionar nova linha após cada erro corrigido.* diff --git a/marketing/skills/brand-strategy/references/estrutura-documento.md b/marketing/skills/brand-strategy/references/estrutura-documento.md deleted file mode 100644 index 4898066..0000000 --- a/marketing/skills/brand-strategy/references/estrutura-documento.md +++ /dev/null @@ -1,252 +0,0 @@ -# Estrutura do Documento — 40 Pontos em 7 Blocos - -Frontmatter obrigatorio: - -```yaml ---- -title: Estrategia de Marca — [Nome da Marca] -version: 1.0 -date: DD-MM-YYYY -author: Descomplicar — Agencia de Aceleracao Digital -code: EST-MRK-0XX -status: draft ---- -``` - -## BLOCO A — Fundamentos (7 pontos) - -### 1. Contexto do sector e mercado -- Panorama actual do sector em Portugal/EU -- Tendencias relevantes (3-5) -- Dados de mercado (TAM se disponivel) -- Mudancas sociais/tecnologicas que afectam o sector - -### 2. Analise de concorrencia -- 3-5 concorrentes directos com: nome, posicionamento, pontos fortes, pontos fracos -- Tabela comparativa -- Gaps/oportunidades nao exploradas - -### 3. SWOT -| | Positivo | Negativo | -|---|----------|----------| -| **Interno** | Forcas (3-5) | Fraquezas (3-5) | -| **Externo** | Oportunidades (3-5) | Ameacas (3-5) | - -Cada ponto deve ser especifico e accionavel (nao "boa qualidade" mas "20 anos de experiencia no sector X"). - -### 4. Apresentacao da empresa/produto -- O que e (1 paragrafo) -- Historia/contexto (breve) -- Servicos/produtos principais (lista) -- Abordagem/metodologia - -### 5. Missao, Visao, Valores -- **Missao:** O que fazemos e para quem (1-2 frases, presente) -- **Visao:** Onde queremos chegar (1-2 frases, futuro) -- **Valores:** 5-7 valores com descricao de 1 frase cada - -### 6. Objectivos estrategicos -- 4-6 objectivos SMART -- Organizados por horizonte temporal (curto/medio/longo prazo) - -### 7. Proposito/Causa -- A razao de existir alem do lucro (1-2 frases) -- "Porque e que o mundo seria pior sem esta marca?" - ---- - -## BLOCO B — Proposta de Valor (5 pontos) - -### 8. Proposta de valor unica -- Formula: "Ajudamos [quem] a [beneficio] atraves de [como], sem [dor que eliminamos]" -- 3-5 beneficios principais (nao funcionalidades) - -### 9. Diferenciais competitivos -- 3-5 diferenciais com justificacao -- O que so esta marca faz/tem - -### 10. Beneficios por camada/segmento -- Funcional: o que resolve concretamente -- Emocional: como faz sentir -- Social: o que diz sobre quem usa - -### 10b. Escada de valor (oferta comercial) -- **Entry** — produto/servico de entrada (baixo risco, primeiro contacto) -- **Core** — oferta principal (maior volume de receita) -- **Premium** — oferta de alto valor (margem maxima, clientes fieis) -- Logica de progressao entre niveis - -### 11. Personalidade da marca -- 5 adjectivos que definem a marca -- Metafora (ex: "Se a marca fosse uma pessoa...") -- O que a marca NUNCA seria - -### 12. Manifesto (opcional, marcas premium) -- Declaracao de crencas (5-10 linhas) -- Tom inspirador e autentico - ---- - -## BLOCO C — Publico (4 pontos) - -### 13. Segmentos de publico-alvo -- Minimo 3 segmentos -- Para cada: nome descritivo, tamanho estimado, prioridade (alta/media/baixa) - -### 14. Personas detalhadas (20 dimensoes por segmento) -Ver `exemplo-persona-20d.md` para formato completo. - -Cada persona deve incluir: -1. Perfil demografico -2. Perfil psicografico -3. Dores -4. Anseios -5. Desejos -6. Frustracoes -7. Preocupacoes -8. Medos -9. Inimigos -10. Linguagem -11. Como procuram ajuda -12. Canais digitais -13. Estilo de decisao -14. Mudancas que procuram -15. Resistencia a mudanca -16. Objecoes tipicas -17. Forma de gerar emocao -18. Argumentos de venda -19. Concorrentes percebidos -20. Propostas recusadas - -### 15. Nichos sectoriais (se aplicavel) -- Tabela com: nicho, dimensao, prioridade (alta/media/baixa), justificacao -- Criterio de priorizacao explicito - -### 16. Personas nomeadas -- Cada segmento deve ter uma persona com nome, idade, profissao, 1 paragrafo de historia - ---- - -## BLOCO D — Comunicacao (7 pontos) - -### 17. Pitch Canvas -5 elementos: -1. **Para quem** — segmento principal -2. **Que tem** — dor/necessidade -3. **O [marca]** — o que e -4. **Que oferece** — beneficio principal -5. **Diferente de** — alternativas - -+ Declaracao de mudanca no mundo (1 frase) - -### 18. Copywriting estrategico -Responder as 10 perguntas do questionamento estrategico (ver metodologia-acida-16ps.md). - -### 19. Pain + Gain por segmento -Para cada segmento: -- **Pain:** 3 dores ordenadas por intensidade -- **Gain:** 3 beneficios que resolvem cada dor -- **Ponte:** como a marca conecta pain a gain - -### 20. Mensagem central da marca -- Tagline/slogan (3-7 palavras) -- Mensagem expandida (1-2 frases) -- Elevador pitch (30 segundos) - -### 21. Headlines por segmento -- 3 headlines por segmento (formato: dor/desejo + solucao) -- 1 headline institucional - -### 22. Narrativa de marca -- Historia da marca (2-3 paragrafos) -- Narrativa por segmento (1 paragrafo cada): Dor -> Solucao -> Resultado - -### 23. Tom de voz e linguagem -- 5 caracteristicas do tom (ex: "profissional mas acessivel") -- Palavras a usar vs palavras a evitar -- Exemplos de frases no tom correcto vs incorrecto - ---- - -## BLOCO E — Activacao (7 pontos) - -### 23b. Experiencia de marca (jornada do cliente) -- **Primeira impressao** — o que ve/sente no primeiro contacto (website, loja, redes) -- **Jornada do cliente** — 5-7 etapas desde descoberta ate fidelizacao -- **Pontos criticos de confianca** — momentos onde a marca ganha ou perde o cliente -- **Momentos WOW** — surpresas positivas que geram recomendacao - -### 24. Demonstracao do produto/servico -- Script de demo por segmento (6 fases: preparacao, introducao, demo, casos uso, Q&A, follow-up) - -### 25. Estrategia de atraccao de clientes -- 5-7 tacticas concretas com canal e accao - -### 26. Estrategia de canais -- Canais prioritarios (ordenados por ROI esperado) -- Funcao de cada canal no funil ACIDA - -### 27. Pilares de conteudo -- 3-5 pilares tematicos -- Tipo de conteudo por pilar -- Frequencia sugerida - -### 28. Casos de uso e testemunhos -- 2-3 cenarios "antes/depois" -- Template para recolha de testemunhos - -### 29. Call-to-action principal -- CTA primario (1) -- CTAs secundarios por fase ACIDA (4) - -### 30. Parcerias estrategicas -- 3-5 tipos de parceiro potencial -- Beneficio mutuo para cada - ---- - -## BLOCO F — Implementacao (6 pontos) - -### 31. Plano de activacao (fases) -- Fase 1 (mes 1-2): fundamentos -- Fase 2 (mes 3-4): lancamento -- Fase 3 (mes 5-6): escala -- Accoes concretas por fase - -### 32. Investimentos prioritarios -- Matriz impacto/esforco (4 quadrantes) -- Top 5 investimentos prioritarios com custo estimado - -### 33. Identidade visual (directrizes) -- Cores primarias e secundarias (hex) -- Tipografia sugerida -- Estilo fotografico -- Elementos graficos - -### 34. KPIs e monitorizacao -- 5-8 KPIs com: nome, baseline, meta, frequencia de medicao -- Dashboard sugerido - -### 35. Inventario de activos de marketing -- Lista de activos necessarios (website, redes, templates, etc.) -- Estado actual (existe/nao existe/precisa actualizacao) - -### 36. FAQ -- 10-15 perguntas frequentes com respostas -- Organizadas por categoria - ---- - -## BLOCO G — Complementos (conforme sector) - -### 37. Enquadramento legal -Apenas se sector regulado. Licencas, certificacoes, normas aplicaveis. - -### 38. Informacoes operacionais -Localizacao, horario, contactos, equipa. - -### 39. Expansao internacional -Apenas se aplicavel. Mercados-alvo, localizacao, logistica. - -### 40. Servicos detalhados -Descricao completa dos servicos/produtos com precos (se publicos). diff --git a/marketing/skills/brand-strategy/references/metodologia-acida-16ps.md b/marketing/skills/brand-strategy/references/metodologia-acida-16ps.md deleted file mode 100644 index 62eb953..0000000 --- a/marketing/skills/brand-strategy/references/metodologia-acida-16ps.md +++ /dev/null @@ -1,80 +0,0 @@ -# Metodologia ACIDA + Framework 16Ps - -## ACIDA — 5 Fases da Jornada - -### A — Atrair a atencao -Conectar com dores e desejos do publico (nao destacar produtos). "O ser humano ocidental recebe em 6 dias mais informacao do que os bisavos em 80 anos." - -### C — Construir confianca -Transparencia, demonstrar compreensao, partilhar conhecimento, educar, estabelecer autoridade. - -### I — Despertar interesse -Comunicacao personalizada por segmento. Rastreamento de interaccoes, conteudo customizado, resolucao antecipada de objecoes, nutricao multi-canal. - -### D — Estimular a decisao -Apresentar proposta onde valor percebido > preco. Superar: duvidas, medo de arrependimento, necessidade de prova social. - -### A — Incentivar a accao -CTAs claros, urgencia, cumprir promessas, superar expectativas. - -## Framework 16Ps — Estrutura Sistematica - -### Bloco A — Fundamentos estrategicos (P1-P4) - -| P | Conteudo | -|---|---------| -| Problema | Problema principal, impacto no cliente, urgencia | -| Proposito | Missao, visao, valores | -| Proposta de valor | Valor unico, diferenciais, beneficios | -| Posicionamento | Posicao no mercado, diferenciacao, percepcao desejada | -| Performance | KPIs, metas, indicadores de sucesso | - -### Bloco B — Publico e pesquisa (P5-P7) - -| P | Conteudo | -|---|---------| -| Publico-alvo | Segmentos, comportamento de compra | -| Pesquisa de mercado | Dados, insights, tendencias | -| Personas | Nome, biografia, dores, objectivos, canais | -| Perfil | Demografico + psicografico (20 dimensoes) | -| Pain Points | Dores, frustracoes, necessidades nao atendidas | - -### Bloco C — Produto e servico (P8-P10) - -| P | Conteudo | -|---|---------| -| Produto/Portfolio | Servicos, caracteristicas, beneficios | -| Preco e valor | Estrategia de precos, posicionamento | -| Processos criticos | Pontos de controlo, qualidade | -| Parcerias estrategicas | Parceiros, beneficios mutuos | -| Plataforma | Canais digitais, infraestrutura | - -### Bloco D — Promocao e comunicacao (P11-P13) - -| P | Conteudo | -|---|---------| -| Promocao | Canais, tacticas, calendario | -| Publicidade | Anuncios, orcamento, frequencia | -| PR | Relacoes publicas, influenciadores | -| Presenca digital | Conteudo, comunidade | -| Proximidade | Narrativa, Pain+Gain, mensagens por persona | - -## Pilares estrategicos Descomplicar - -- Website como hub central (nao redes sociais) -- Proposta de valor: "problema -> solucao -> resultados" -- Ecossistema multi-canal: email, SMS/WhatsApp, SEO, Ads, website, social -- Melhoria continua baseada em metricas - -## Questionamento estrategico para copywriting (10 perguntas) - -1. Qual e o objectivo da comunicacao? -2. Quem e o publico-alvo? -3. Qual e a oferta? -4. Qual e o beneficio principal? -5. Quais sao as dores e desejos do publico? -6. Qual e a prova social? -7. Quais sao as objecoes potenciais? -8. Qual e a narrativa/historia? -9. Onde a mensagem sera veiculada? -10. Qual e o call-to-action?