claude-plugins/crm-ops/skills/estrategia-marca/SKILL.md

name, description

name

description

estrategia-marca

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

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)

Standard canónico em Cloud/Descomplicar/ACIDA/Estrategia-de-Marca/ (caminho local: /media/ealmeida/Dados/Cloud/Descomplicar/ACIDA/Estrategia-de-Marca/):

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 <ficheiro> [--completo]

Esta skill implementa o PROC. Se algo aqui contradisser a SPEC, prevalece a SPEC.

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.

Níveis

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)

Se o pedido for ambíguo, Standard. "Completa", "com todos os elementos" ou "como a da Descomplicar" = Completo.

Fases

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.

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

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

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.

Fase 5. Pitch canvas

Para quem, problema, solução, resultado, porquê nós, mais a declaração de mudança no mundo.

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.

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.

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 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 <dir> --intro intro.md --briefing briefing-llm.md --config marca.json --out <ficheiro>.md [--glossario …] [--historico …]. Gera o anexo A com todos os [a validar].
4. Validar: node <ACIDA>/Estrategia-de-Marca/validador-estrategia-marca.mjs <ficheiro>.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 <ficheiro>.md <ficheiro>.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).

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.

Checklist de entrega

• 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

Erros a evitar

• 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.

Referências

Ficheiro	Quando carregar
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 · 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

Lido antes de executar. Acrescentar uma linha por erro corrigido.

{"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"}