---
name: estrategia-marca
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

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.

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