feat(crm-ops): estrategia-marca 1.3.0 — SPEC v2.0, versão completa (36 capítulos), redação em paralelo, montagem e PDF A4; funde marketing:brand-strategy (marketing 2.1.0)
This commit is contained in:
AIkTop
@@ -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 <ficheiro> [--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 <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).
|
||||
|
||||
**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.*
|
||||
|
||||
Reference in New Issue
Block a user