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)

2026-10-17 01:39:40 +01:00
parent bce12944ae
commit c18bb90ff6
16 changed files with 662 additions and 590 deletions
@@ -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 <MARCA> (<sector>, <país>), nível Completo.
+Cada subagente escreve UMA parte; o orquestrador junta.
+
+# Estrutura global (contrato; numeração fixa)
+<colar a lista de capítulos de references/estrutura-completa.md, Partes I a VIII,
+com o "Contém" de cada capítulo>
+
+# Fontes (ler as relevantes; NÃO inventar factos)
+- Briefing e notas da entrevista: <caminho>
+- Pesquisa de mercado (Fase 0): <caminho>/Pesquisas/sintese-mercado.md
+- Material do cliente (site, catálogo, propostas, manual de marca): <caminhos/URLs>
+- Desk CRM / OKF do cliente: <ids ou caminhos>
+- 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 <cliente>]`.
+- 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-<romano>.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 <romano>. <nome>: capítulos <N> a <M>. Ficheiro: local://marca/parte-<romano>.md.
+
+# Change
+- Cap. N: <o que entra, tirado de estrutura-completa.md, adaptado ao cliente>
+- …
+
+# 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).