zark-seo 1.1.0 → 1.2.1

package/bin/cli.js

@@ -49,7 +49,7 @@ async function copyDir(src, dest) {
 }
 
 async function appendNoteToContextFiles(targetRoot, skillsDirName) {
-  const note = `\n\n## SEO & GEO Skills (ZARK)\nEste projeto tem o **ZARK SEO & GEO Skills Stack** instalado em \`${skillsDirName}/\` — 14 skills (1 orquestrador + 13 especialistas) em SEO Local, SEO técnico, SEO de conteúdo e GEO (otimização para LLMs).\n\n**Como usar:**\n- Em pedidos amplos ("monta plano de SEO completo", "cliente novo chegou", "como começo SEO") → consulte \`${skillsDirName}/seo-orchestrator-SKILL.md\` que roteia pra sequência correta.\n- Em pedidos específicos ("auditoria do site", "criar schema", "otimizar GBP", "página de cidade", "GEO/LLM SEO") → consulte a skill correspondente em \`${skillsDirName}/\`.\n- Lista completa de skills + pipelines documentados em \`${skillsDirName}/README.md\`.\n\nCada skill tem frontmatter \`name\` + \`description\` com triggers naturais — Claude Code roteia automaticamente; em outros clientes (Cursor/Codex/Aider) a IA usa o README como índice.\n\nFoco BR (CNPJ, CEP, +55, diretórios BR, idioma PT-BR). Stack derivado de auditoria real (não teórico).\n`;
+  const note = `\n\n## SEO & GEO Skills (ZARK)\nEste projeto tem o **ZARK SEO & GEO Skills Stack** instalado em \`${skillsDirName}/\` — 17 skills (1 orquestrador + 16 especialistas) em SEO Local, SEO técnico, SEO de conteúdo, GEO (otimização para LLMs), brand voice e automação GBP.\n\n**Como usar:**\n- Em pedidos amplos ("monta plano de SEO completo", "cliente novo chegou", "como começo SEO") → consulte \`${skillsDirName}/seo-orchestrator-SKILL.md\` que roteia pra sequência correta.\n- Em pedidos específicos (auditoria, schema, GBP, página de cidade, GEO/LLM, voz da marca, keyword research, posts GBP) → consulte a skill correspondente em \`${skillsDirName}/\`.\n- Lista completa de skills + pipelines documentados em \`${skillsDirName}/README.md\`.\n\nCada skill tem frontmatter \`name\` + \`description\` com triggers naturais — Claude Code roteia automaticamente; em outros clientes (Cursor/Codex/Aider) a IA usa o README como índice.\n\nFoco BR (CNPJ, CEP, +55, diretórios BR, idioma PT-BR). Stack derivado de auditoria real (não teórico).\n`;
 
   const candidates = [
     path.join(targetRoot, '.ai-context', 'CONTEXT.md'),
@@ -79,7 +79,7 @@ async function appendNoteToContextFiles(targetRoot, skillsDirName) {
 function printHelp(version) {
   banner(`zark-seo v${version}`);
   console.log(`  ${c.bold('Comandos:')}\n`);
-  console.log(`    ${c.green('init')} ${c.dim('[pasta]')}   instala 14 skills SEO/GEO (default: ./seo-skills)`);
+  console.log(`    ${c.green('init')} ${c.dim('[pasta]')}   instala 17 skills SEO/GEO (default: ./seo-skills)`);
   console.log(`    ${c.green('help')}            mostra esta ajuda`);
   console.log(`    ${c.green('version')}         mostra a versão\n`);
   console.log(`  ${c.bold('Uso:')}`);
@@ -87,15 +87,16 @@ function printHelp(version) {
   console.log(`    npx zark-seo init ./skills           ${c.dim('# instala em ./skills')}`);
   console.log(`    npx zark-seo init --force            ${c.dim('# sobrescreve se já existe')}\n`);
   console.log(`  ${c.bold('Filosofia:')}`);
-  console.log(`    14 skills (1 orquestrador + 13 especialistas) em SEO Local, técnico, conteúdo e GEO.`);
+  console.log(`    17 skills (1 orquestrador + 16 especialistas) em SEO Local, técnico, conteúdo, GEO, brand voice e GBP automation.`);
   console.log(`    Cada skill tem frontmatter com triggers naturais — Claude Code roteia auto;`);
   console.log(`    em outros clientes a IA usa o README como índice. Foco mercado brasileiro.\n`);
   console.log(`  ${c.bold('Skills incluídas:')}`);
   console.log(`    ${c.dim('Orquestrador:')}  seo-orchestrator`);
   console.log(`    ${c.dim('Diagnóstico:')}   seo-local-auditor · competitor-gap-analyzer`);
-  console.log(`    ${c.dim('Local SEO:')}     gbp-optimizer · service-area-page-builder · citations-builder-br`);
+  console.log(`    ${c.dim('Local SEO:')}     gbp-optimizer · service-area-page-builder · citations-builder-br · gbp-posts-engine`);
   console.log(`    ${c.dim('Técnico:')}       schema-jsonld-builder · meta-tags-optimizer · core-web-vitals-fixer · seo-technical-engineer`);
-  console.log(`    ${c.dim('Conteúdo:')}      topical-authority-architect · seo-content-writer-br`);
+  console.log(`    ${c.dim('Conteúdo:')}      topical-authority-architect · seo-content-writer-br · brand-voice-extractor ★`);
+  console.log(`    ${c.dim('Pesquisa:')}      keyword-research-validator`);
   console.log(`    ${c.dim('Off-site:')}      review-acquisition-engine`);
   console.log(`    ${c.dim('LLM/GEO:')}       geo-llm-optimizer ★\n`);
 }
@@ -147,7 +148,7 @@ async function runInit(args) {
   }
 
   console.log('');
-  console.log(c.green(`✓ 14 skills instaladas em ${skillsDirName}/`));
+  console.log(c.green(`✓ 17 skills instaladas em ${skillsDirName}/`));
   console.log('');
   console.log(c.bold('Próximo passo:'));
   console.log(`  ${c.dim('•')} Diga pra IA: "leia ${skillsDirName}/README.md e use as skills SEO/GEO conforme contexto"`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zark-seo",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "ZARK SEO & GEO Skills Stack — install via `npx zark-seo init` to drop 14 SEO/GEO specialist skills (1 orchestrator + 13 specialists in Local SEO, technical SEO, content, GEO/LLM optimization) as REFERENCE for AI in any project. Brazilian market focus, derived from real ZARK audits.",
   "type": "module",
   "bin": {

package/templates/README.md

@@ -1,6 +1,6 @@
 # 🚀 ZARK SEO & GEO Skills Stack
 
-Stack completo de **13 skills especialistas** (+ 1 orquestrador) em SEO Local, SEO técnico, SEO de conteúdo e GEO (Generative Engine Optimization) para o mercado brasileiro. Cada skill é autocontida, especialista em uma frente específica, e foi desenhada pra ser composta com as demais.
+Stack completo de **16 skills especialistas** (+ 1 orquestrador) em SEO Local, SEO técnico, SEO de conteúdo, GEO (Generative Engine Optimization), brand voice e automação GBP para o mercado brasileiro. Cada skill é autocontida, especialista em uma frente específica, e foi desenhada pra ser composta com as demais.
 
 > **Contexto de criação:** desenvolvido pela ZARK em maio de 2026 a partir de auditoria real (Limppetec) que evidenciou os gaps mais comuns de SEO em PMEs brasileiras. As skills incorporam o stack ZARK Chat / n8n / Evolution API / Supabase para automação operacional.
 
@@ -22,9 +22,12 @@ Stack completo de **13 skills especialistas** (+ 1 orquestrador) em SEO Local, S
 | 10 | `competitor-gap-analyzer` | Análise competitiva em 3 dimensões | "analisar concorrentes", "gap analysis", "espionar concorrente" |
 | 11 | `citations-builder-br` | Cadastro em diretórios BR com NAP consistente | "cadastrar em diretórios", "NAP", "citations", "presença online" |
 | 12 | `geo-llm-optimizer` | Otimização para LLMs (ChatGPT, Claude, Gemini, Perplexity) ★ | "GEO", "aparecer no ChatGPT", "ranking em IA", "LLM SEO" |
-| 13 | `seo-technical-engineer` | SEO técnico avançado (indexação, crawl, JS rendering, migração, robots/sitemap, GSC errors) | "site não indexa", "Search Console com erro", "JavaScript SEO", "migrar domínio", "Crawled not indexed", "robots.txt", "Soft 404" |
+| 13 | `seo-technical-engineer` | SEO técnico avançado (indexação, crawl, JS rendering, migração, GSC errors) | "site não indexa", "Search Console com erro", "JavaScript SEO", "migrar domínio", "robots.txt" |
+| 14 | `brand-voice-extractor` ★ | Extrai e codifica voz autêntica da marca (anti AI-slop) — fundação pra todo conteúdo | "fazer parecer que eu escrevi", "que não pareça IA", "voz da marca", "tom de voz" |
+| 15 | `keyword-research-validator` | Valida keywords por volume + CPC ANTES de criar páginas/serviços (winning keywords) | "pesquisar keyword", "tem busca pra esse termo?", "winning keywords", "vale a pena rankear" |
+| 16 | `gbp-posts-engine` | Gera posts GBP em escala com justification baiting + automação n8n | "posts do Google Meu Negócio", "automatizar posts GBP", "yellow badge", "gerar posts em lote" |
 
-★ = moat competitivo ZARK em 2026
+★ = moat competitivo ZARK em 2026 (`geo-llm-optimizer` + `brand-voice-extractor` = combate AI-slop por dois ângulos)
 
 ---
 
@@ -36,19 +39,22 @@ Cliente chegou. Empresa com presença digital fraca ou nenhuma. Aplicar nessa or
 
 ```
 Semana 1     ┌─ 1. seo-local-auditor          (diagnóstico inicial)
-             └─ 10. competitor-gap-analyzer    (contextualizar gaps)
+             ├─ 10. competitor-gap-analyzer    (contextualizar gaps)
+             ├─ 14. brand-voice-extractor      (capturar voz ANTES de qualquer conteúdo)
+             └─ 15. keyword-research-validator (validar serviços + cidades antes de criar páginas)
                        │
 Semana 2-3   ┌─ 13. seo-technical-engineer    (fundação técnica: indexação, rendering, sitemap)
-             ├─ 3. gbp-optimizer               (60% do ranking Local)
+             ├─ 3. gbp-optimizer               (60% do ranking Local — usa keywords validadas)
              ├─ 2. schema-jsonld-builder       (fundação de entidade)
              └─ 6. core-web-vitals-fixer       (performance se aplicável)
                        │
-Semana 4-6   ┌─ 7. topical-authority-architect (arquitetura conteúdo)
-             ├─ 4. service-area-page-builder   (expansão geográfica)
+Semana 4-6   ┌─ 7. topical-authority-architect (arquitetura conteúdo — usa keywords validadas)
+             ├─ 4. service-area-page-builder   (expansão geográfica — usa keywords validadas)
              └─ 11. citations-builder-br       (presença off-site)
                        │
-Semana 7-12  ┌─ 8. seo-content-writer-br       (produção)
+Semana 7-12  ┌─ 8. seo-content-writer-br       (produção — usa brand-voice como referência)
              ├─ 5. meta-tags-optimizer         (toda página criada)
+             ├─ 16. gbp-posts-engine           (posts GBP em escala + automação n8n)
              └─ 9. review-acquisition-engine   (sistema contínuo)
                        │
 Mês 4+       └─ 12. geo-llm-optimizer          (vetor competitivo)
@@ -60,6 +66,7 @@ Cliente já é ZARK há tempos. Mantém:
 
 ```
 Mensal        ─ 9. review-acquisition-engine    (resposta a reviews + monitoramento)
+              ─ 16. gbp-posts-engine            (4-8 posts GBP/mês via automação)
               ─ 8. seo-content-writer-br        (produção contínua de conteúdo)
               ─ 5. meta-tags-optimizer          (toda página/post novo)
 
@@ -68,9 +75,11 @@ Trimestral    ─ 1. seo-local-auditor            (re-auditoria)
               ─ 11. citations-builder-br        (manutenção NAP)
               ─ 12. geo-llm-optimizer           (re-medir BMR/SOV)
               ─ 13. seo-technical-engineer      (re-check GSC, indexação, redirects)
+              ─ 15. keyword-research-validator  (mercado evolui — re-validar)
 
 Semestral     ─ 6. core-web-vitals-fixer        (validar performance)
               ─ 7. topical-authority-architect  (refresh de estratégia)
+              ─ 14. brand-voice-extractor       (re-extrair se cliente mudou tom)
 ```
 
 ### Pipeline C — Criação de site novo (do zero, com Claude Code)
@@ -78,22 +87,26 @@ Semestral     ─ 6. core-web-vitals-fixer        (validar performance)
 Site novo de cliente ZARK. Claude Code monta tudo:
 
 ```
-Planejamento  ┌─ 7. topical-authority-architect (definir estrutura semântica)
-              └─ 10. competitor-gap-analyzer    (validar diferenciação)
+Pré-planejamento ┌─ 14. brand-voice-extractor    (extrair voz do cliente ANTES de tudo)
+                 └─ 15. keyword-research-validator (validar cidades + serviços com volume real)
                        │
-Estrutura     ┌─ 4. service-area-page-builder   (páginas de cidade)
-              └─ 8. seo-content-writer-br       (cada página)
+Planejamento     ┌─ 7. topical-authority-architect (estrutura semântica — usa keywords validadas)
+                 └─ 10. competitor-gap-analyzer    (validar diferenciação)
                        │
-Por página    ┌─ 5. meta-tags-optimizer         (title/desc/OG)
-              └─ 2. schema-jsonld-builder       (schema apropriado)
+Estrutura        ┌─ 4. service-area-page-builder   (páginas de cidade — só as validadas)
+                 └─ 8. seo-content-writer-br       (cada página — usa brand-voice)
                        │
-Pré-launch    ┌─ 13. seo-technical-engineer    (robots.txt, sitemap, rendering, redirects)
-              ├─ 6. core-web-vitals-fixer       (validar performance)
-              └─ 1. seo-local-auditor           (checklist final)
+Por página       ┌─ 5. meta-tags-optimizer         (title/desc/OG)
+                 └─ 2. schema-jsonld-builder       (schema apropriado)
                        │
-Pós-launch    ┌─ 3. gbp-optimizer               (vincular ao site)
-              ├─ 11. citations-builder-br       (cadastros)
-              └─ 9. review-acquisition-engine   (ativar sistema)
+Pré-launch       ┌─ 13. seo-technical-engineer    (robots.txt, sitemap, rendering, redirects)
+                 ├─ 6. core-web-vitals-fixer       (validar performance)
+                 └─ 1. seo-local-auditor           (checklist final)
+                       │
+Pós-launch       ┌─ 3. gbp-optimizer               (vincular ao site)
+                 ├─ 16. gbp-posts-engine           (calendário automático de posts)
+                 ├─ 11. citations-builder-br       (cadastros)
+                 └─ 9. review-acquisition-engine   (ativar sistema)
 ```
 
 ### Pipeline D — Pivot pra GEO (cliente com fundação pronta)
@@ -122,25 +135,30 @@ Mês 7-12      └─ 12. geo-llm-optimizer          (Wikipedia se elegível, aw
 | "Site React/Vue/Next não rankeia" | 13 | 6, 5 |
 | "Search Console com 'Crawled not indexed'" | 13 | 1, 8 |
 | "Quero migrar de domínio sem perder ranking" | 13 | 5, 2, 11 |
-| "Mudei de HTTP pra HTTPS / www pra non-www" | 13 | — |
-| "Site grande, só 10% das páginas estão indexadas" | 13 | 6 |
-| "Auditoria SEO geral" | 1 | 3, 6, 11 |
-| "Quero rankear em [cidade]" | 4 | 1, 3, 11 |
-| "Como aparecer mais no Google Meu Negócio?" | 3 | 9, 11 |
+| "Quero rankear em [cidade]" | 15 → 4 | 1, 3, 11 |
+| "Como aparecer mais no Google Meu Negócio?" | 3 | 9, 11, 16 |
+| "Preciso automatizar posts do Google Meu Negócio" | 16 | 3, 14 |
+| "Yellow badge", "posts em lote GBP" | 16 | 3 |
 | "Preciso de mais reviews" | 9 | 3 |
-| "Site tá lento" | 6 | 1 |
-| "Como escrever um artigo que rankeia?" | 8 | 7, 5, 2 |
+| "Site tá lento" | 6 | 1, 13 |
+| "Como escrever um artigo que rankeia?" | 8 | 7, 5, 2, 14, 15 |
 | "Quero saber o que falta pra superar [concorrente]" | 10 | 1, 3, 7 |
 | "Em quais sites devo cadastrar minha empresa?" | 11 | 3 |
-| "Como aparecer no ChatGPT?" | 12 | 2, 8 |
-| "Quero plano de conteúdo de blog" | 7 | 8, 10 |
-| "Como otimizar a página de [serviço]?" | 8 | 5, 2 |
+| "Como aparecer no ChatGPT?" | 12 | 2, 8, 14 |
+| "Quero plano de conteúdo de blog" | 15 → 7 | 8, 10, 14 |
+| "Quais keywords valem a pena rankear?" | 15 | 7, 10 |
+| "Tem busca pra esse termo?" | 15 | — |
+| "Quais cidades atacar primeiro?" | 15 | 4, 3 |
+| "Como otimizar a página de [serviço]?" | 8 | 5, 2, 14 |
 | "Preview do meu link tá feio no WhatsApp" | 5 | — |
 | "Schema do meu site tá certo?" | 2 | 1 |
-| "GEO vale a pena?" | 12 | 1 (validar fundação) |
-| "Quero criar um site novo" | 7 → 4 → 8 → 5 → 2 → 6 → 1 | (pipeline C) |
-| "Cliente novo, monta plano completo" | 1 → 10 → todas | (pipeline A) |
+| "GEO vale a pena?" | 12 | 1 (validar fundação), 14 (voz autêntica) |
+| "Fazer parecer que eu escrevi" / "que não pareça IA" | 14 | 8 |
+| "Voz da marca" / "tom de voz" / "padronizar comunicação" | 14 | 8 |
+| "Quero criar um site novo" | 14 → 15 → 7 → 4 → 8 → 5 → 2 → 13 → 6 → 1 | (pipeline C) |
+| "Cliente novo, monta plano completo" | 1 → 10 → 14 → 15 → todas | (pipeline A) |
 | "Como medir se SEO tá funcionando?" | 1 (re-auditoria) + 12 (BMR) | 10 |
+| "Auditoria SEO geral" | 1 | 3, 6, 11, 13 |
 
 ---
 

package/templates/brand-voice-extractor-SKILL.md

@@ -0,0 +1,427 @@
+---
+name: brand-voice-extractor
+description: Extrai e codifica a voz autêntica de uma pessoa ou marca a partir de materiais existentes (posts de LinkedIn, e-mails, transcrições de calls, mensagens de WhatsApp, vídeos) em arquivos de referência reutilizáveis (tom, vocabulário, humor, crenças, contexto de negócio) que fazem todo conteúdo futuro soar humano e autêntico — combatendo o "AI-slop" na raiz. Use SEMPRE que o usuário pedir para "capturar minha voz", "fazer o conteúdo soar como eu", "extrair meu tom de voz", "brand voice", "tom de voz da marca", "fazer parecer que eu escrevi", "personalizar a escrita", "treinar a IA pra escrever como eu", "voz da empresa", "meu estilo de escrita", "que não pareça IA", "deixar com a minha cara", "padronizar a comunicação da marca". Acionar TAMBÉM antes de produzir conteúdo em volume (blog, posts, páginas) quando o cliente quer autenticidade, e sempre que a skill seo-content-writer-br precisar de referência de voz. Produz arquivos .md de referência (tone.md, vocabulary.md, humor.md, beliefs.md, business-context.md) que outras skills consomem.
+---
+
+# Brand Voice Extractor — Padrão ZARK
+
+Skill especialista em capturar a voz autêntica de uma pessoa ou marca e codificá-la em arquivos de referência reutilizáveis. É a fundação anti-AI-slop de toda produção de conteúdo ZARK.
+
+## Por que essa skill é a mais importante pra qualidade de conteúdo
+
+**O problema central do conteúdo gerado por IA não é gramática — é autenticidade.** Texto de IA é tecnicamente correto mas soa genérico, sem alma, igual a milhões de outros. Leitor sente. Google detecta padrão. Cliente percebe que "não soa como ele".
+
+A solução não é "escrever melhor" no abstrato. É **dar à IA referências concretas da voz real** — como a pessoa fala, que palavras usa, que piadas faz, no que acredita. Com essas referências, a IA para de escrever "voz de IA genérica" e passa a escrever "voz daquela pessoa específica".
+
+**Essa skill produz 5 arquivos de referência que todas as outras skills de conteúdo consomem:**
+- `tone.md` — como a pessoa/marca soa
+- `vocabulary.md` — palavras e expressões que usa (e que evita)
+- `humor.md` — tipo de humor, quando e como
+- `beliefs.md` — convicções, opiniões, posicionamentos
+- `business-context.md` — o que o negócio faz, pra quem, diferenciais
+
+Uma vez criados, esses arquivos são reusados em toda produção: blog post soa como o dono escreveu, post de GBP soa autêntico, resposta a review soa humana, página de serviço tem personalidade.
+
+## Princípios não-negociáveis
+
+1. **Extrair de material REAL, não inventar.** A voz vem de textos que a pessoa já escreveu — LinkedIn, e-mails, transcrições, mensagens. Não inventar uma voz fictícia.
+
+2. **Específico vence genérico.** "Tom profissional" é inútil. "Direto, sem rodeios, usa analogias do dia-a-dia, abre com pergunta provocativa" é acionável.
+
+3. **Capturar o que evitar, não só o que usar.** Tão importante quanto saber as palavras que a pessoa usa é saber as que ela nunca usaria.
+
+4. **Humor é o maior diferenciador.** Conteúdo com humor genuíno retém leitor, gera engajamento, sinaliza qualidade pro Google. Capturar o humor específico é prioridade.
+
+5. **Atualização contínua.** Voz evolui. Arquivos de referência se atualizam conforme mais material aparece.
+
+6. **Um conjunto por entidade.** Pessoa tem sua voz; marca tem a sua. Se o dono É a marca (personal brand), um conjunto. Se a marca é institucional, voz da marca.
+
+7. **Os arquivos são consumidos por outras skills.** Esta skill produz referência; skills de conteúdo (8, e os aprimoramentos) consomem. Sempre estruturar pra reuso.
+
+## Fluxo de execução
+
+### Etapa 1 — Coleta de material-fonte
+
+Pedir ao usuário o máximo de material onde a voz autêntica aparece. Em ordem de qualidade:
+
+**Material de altíssimo valor (priorizar):**
+- Posts de LinkedIn (texto pensado, voz profissional autêntica)
+- Transcrições de vídeos/podcasts da pessoa (voz falada natural)
+- Transcrições de calls de venda (como a pessoa convence)
+- Áudios de WhatsApp transcritos (voz mais solta)
+
+**Material de bom valor:**
+- E-mails escritos pela pessoa (não templates)
+- Mensagens de WhatsApp/Telegram pessoais
+- Legendas de Instagram/posts de redes sociais
+- Respostas que a pessoa deu em comentários
+
+**Material de valor médio:**
+- Textos do site (frequentemente já são "marketês", menos autênticos)
+- Material de marketing existente
+
+**Quanto mais material, melhor.** Mínimo viável: 3-5 peças substanciais. Ideal: 10-20 peças variadas.
+
+**Como pedir:**
+
+```
+Pra capturar sua voz de verdade, preciso de exemplos do que você já escreveu ou falou. Quanto mais, melhor. Me manda o que tiver:
+
+1. Seus últimos 5-10 posts de LinkedIn (copia e cola)
+2. Transcrição de algum vídeo/podcast seu, se tiver
+3. Alguns e-mails ou mensagens que VOCÊ escreveu (não templates)
+4. Qualquer texto onde você soa como você de verdade
+
+Pode mandar tudo de uma vez. Vou extrair os padrões da sua voz.
+```
+
+Se o cliente é empresa institucional (não personal brand), pedir:
+- Material de marketing que representa bem a marca
+- Comunicações que o time considera "a nossa cara"
+- Manifesto/missão/valores se houver
+
+### Etapa 2 — Análise de padrões
+
+Ao receber o material, analisar em 5 dimensões:
+
+#### Dimensão 1 — TONE (tom)
+
+Identificar:
+- **Registro:** formal, casual, técnico, conversacional?
+- **Energia:** calmo, empolgado, intenso, tranquilo?
+- **Postura:** confiante, humilde, provocador, acolhedor?
+- **Ritmo:** frases curtas e secas? longas e elaboradas? mistura?
+- **Distância:** próximo (fala "você"), distante (impessoal)?
+- **Padrões de abertura:** como começa um texto? Pergunta? Afirmação forte? História?
+- **Padrões de fechamento:** como encerra? CTA? Reflexão? Provocação?
+
+#### Dimensão 2 — VOCABULARY (vocabulário)
+
+Identificar:
+- **Palavras-assinatura:** termos que a pessoa usa repetidamente
+- **Expressões características:** frases que ela repete ("no fim das contas", "pra ser direto")
+- **Jargão do nicho:** termos técnicos que domina
+- **Gírias/regionalismos:** usa? Quais?
+- **Nível de formalidade lexical:** "vc" ou "você"? "tá" ou "está"?
+- **Palavras que EVITA:** o que nunca aparece (importante!)
+- **Conectores preferidos:** como liga ideias
+
+#### Dimensão 3 — HUMOR
+
+Identificar:
+- **Tem humor?** Quanto?
+- **Tipo:** sarcástico, autodepreciativo, observacional, pastelão, dad jokes, ironia?
+- **Frequência:** humor constante ou pontual?
+- **Timing:** onde insere humor? Abertura? Meio? Como alívio?
+- **Referências:** cultura pop, internet, regionais, do nicho?
+- **Limites:** que tipo de humor NÃO combina com a marca?
+
+#### Dimensão 4 — BELIEFS (crenças e posicionamentos)
+
+Identificar:
+- **Convicções centrais:** no que a pessoa acredita sobre seu mercado?
+- **Opiniões fortes:** contra o quê ela se posiciona?
+- **Filosofia de trabalho:** como acha que as coisas devem ser feitas?
+- **Inimigos declarados:** que práticas ela critica?
+- **Valores:** o que ela valoriza e defende?
+
+Isso dá substância ao conteúdo — opinião real em vez de texto morno.
+
+#### Dimensão 5 — BUSINESS CONTEXT (contexto de negócio)
+
+Identificar (do site + material):
+- O que o negócio faz exatamente
+- Pra quem (cliente ideal)
+- Diferenciais reais
+- Serviços/produtos principais
+- Como se posiciona vs concorrência
+- Provas (números, casos, anos de mercado)
+
+### Etapa 3 — Geração dos 5 arquivos de referência
+
+Produzir cada arquivo em formato consumível por outras skills.
+
+#### tone.md
+
+```markdown
+# Tom de Voz — [Nome/Marca]
+
+## Registro
+[Descrição: formal/casual/técnico + nuances]
+
+## Energia e postura
+[Descrição]
+
+## Ritmo de escrita
+- Frases: [curtas/longas/mistura]
+- Parágrafos: [densos/arejados]
+- [Padrões específicos observados]
+
+## Como abre um texto
+[Padrões de abertura com exemplos reais extraídos]
+
+## Como fecha um texto
+[Padrões de fechamento com exemplos]
+
+## Distância com o leitor
+[Próximo/distante, usa "você", etc]
+
+## Estrutura que costuma usar
+[Padrão de montagem do texto: hook → cena → desenvolvimento → fechamento. Extrair do material real.]
+
+## "Tells" — marcas registradas que denunciam que é essa pessoa
+[Frases/construções que a pessoa repete e que ninguém mais usa igual. Ex: começa sempre com "Olha,", usa "no fim das contas", abre com pergunta retórica, fecha com frase seca sem moral da história. Esses tells são o que mais faz o texto soar autêntico.]
+
+## Exemplos reais (extraídos do material)
+> "[trecho real que exemplifica o tom]"
+> "[outro trecho]"
+
+## O que o tom NÃO é
+[Ex: nunca corporativo-formal, nunca distante, nunca exagerado]
+```
+
+> **Nota de qualidade:** os melhores arquivos `tone.md` têm uma seção de **"tells"** (marcas registradas) e uma de **"o que evita"**. São essas duas que mais separam "texto que parece a pessoa" de "texto de IA genérico". O exemplo real do método original tinha tells como `"the tl;dr is this:"`, framing `"Old way: … New way: …"`, e nomear ferramentas específicas em vez de dizer "uma ferramenta". Capture esse nível de especificidade.
+
+#### vocabulary.md
+
+```markdown
+# Vocabulário — [Nome/Marca]
+
+## Palavras-assinatura (usa muito)
+- [palavra/expressão] — [contexto de uso]
+- [...]
+
+## Expressões características
+- "[expressão real]"
+- "[outra]"
+
+## Jargão do nicho que domina
+- [termo] — [como usa]
+
+## Nível de formalidade
+- Usa "[você/vc]", "[está/tá]", etc.
+
+## Conectores preferidos
+- [como liga ideias]
+
+## Palavras que EVITA (nunca usar)
+- [palavra] — [por quê não combina]
+- [...]
+
+## Exemplos reais
+> "[trecho mostrando vocabulário típico]"
+```
+
+#### humor.md
+
+```markdown
+# Humor — [Nome/Marca]
+
+## Tem humor? Quanto?
+[Avaliação]
+
+## Tipo de humor
+[Sarcástico/autodepreciativo/observacional/dad jokes/etc]
+
+## Quando e onde usa
+[Padrões: abertura, alívio cômico, fechamento]
+
+## Referências que usa
+[Cultura pop, internet, regional, nicho]
+
+## Exemplos reais
+> "[piada/trecho engraçado real do material]"
+> "[outro]"
+
+## Limites (humor que NÃO combina)
+[Ex: nunca ofensivo, nunca forçado, nunca sobre X]
+```
+
+#### beliefs.md
+
+```markdown
+# Crenças e Posicionamentos — [Nome/Marca]
+
+## Convicções centrais sobre o mercado
+- [crença] — [como se manifesta]
+
+## Posicionamentos fortes (contra o quê)
+- Contra [prática] porque [razão]
+
+## Filosofia de trabalho
+[Como acredita que as coisas devem ser feitas]
+
+## Valores defendidos
+- [valor]
+
+## Frases de manifesto (extraídas)
+> "[trecho onde a pessoa expressa convicção]"
+
+## Como isso aparece no conteúdo
+[Orientação pra skills: usar essas convicções pra dar opinião real]
+```
+
+#### business-context.md
+
+```markdown
+# Contexto de Negócio — [Marca]
+
+## O que fazemos
+[Descrição clara]
+
+## Para quem (cliente ideal)
+[Perfil]
+
+## Diferenciais reais
+- [diferencial tangível]
+
+## Serviços/produtos principais
+- [item]
+
+## Posicionamento vs concorrência
+[Como se diferencia]
+
+## Provas (números, casos, autoridade)
+- [prova concreta]
+
+## Cidades/região atendida
+[Se Local SEO relevante]
+```
+
+### Etapa 4 — Validação com o usuário
+
+Após gerar, mostrar ao usuário e perguntar:
+
+```
+Criei os arquivos de referência da sua voz. Antes de finalizar, valida:
+
+1. O tom capturado soa como você? [mostrar tone.md]
+2. As palavras-assinatura batem? [mostrar vocabulary.md]
+3. O humor está certo? [mostrar humor.md]
+4. As crenças representam você? [mostrar beliefs.md]
+
+O que ajustar?
+```
+
+Iterar até o usuário confirmar "sim, é assim que eu soo".
+
+### Etapa 5 — Instruções de uso
+
+Explicar como os arquivos são usados:
+
+```
+Pronto. Seus 5 arquivos de voz estão criados. A partir de agora, qualquer conteúdo que a gente produzir (blog, posts, páginas, respostas) vai referenciar esses arquivos pra soar como você.
+
+No Claude Code, sempre que for gerar conteúdo, referencie:
+@tone.md @vocabulary.md @humor.md @beliefs.md @business-context.md
+
+Ou simplesmente: "escreve referenciando minha voz" — e as skills puxam automaticamente.
+
+Conforme você produz mais material, a gente atualiza esses arquivos pra ficarem cada vez mais precisos.
+```
+
+## Estrutura de pastas recomendada
+
+```
+projeto-cliente/
+└── reference/
+    ├── tone.md
+    ├── vocabulary.md
+    ├── humor.md
+    ├── beliefs.md
+    └── business-context.md
+```
+
+Manter na pasta `reference/` pra outras skills encontrarem facilmente.
+
+## Como outras skills consomem esses arquivos
+
+| Skill | Como usa a voz |
+|---|---|
+| `seo-content-writer-br` (8) | Toda peça referencia os 5 arquivos antes de escrever |
+| `gbp-optimizer` (3) | Descrição e posts do GBP soam autênticos |
+| `review-acquisition-engine` (9) | Respostas a reviews soam humanas, não corporativas |
+| `service-area-page-builder` (4) | Páginas de cidade têm personalidade da marca |
+| `topical-authority-architect` (7) | Conteúdo do cluster mantém voz consistente |
+
+## Diferença entre voz pessoal e voz de marca
+
+**Personal brand (dono = marca):**
+Extrair do dono. Voz pessoal vira voz da marca. Ex: consultor, advogado autônomo, médico com marca própria.
+
+**Marca institucional (time, vários porta-vozes):**
+Extrair da "persona da marca" — como a marca soa, independente de quem escreve. Pode ser construída a partir de material aprovado + decisão de posicionamento.
+
+**Híbrido (marca com rosto):**
+Dono é o rosto, mas marca tem identidade própria. Dois conjuntos: voz do dono (pra conteúdo pessoal) + voz da marca (pra institucional).
+
+## Erros comuns que esta skill EVITA
+
+1. **Inventar voz em vez de extrair.** Voz vem de material real, não de suposição.
+
+2. **Descrição genérica ("tom profissional").** Inútil. Específico e acionável sempre.
+
+3. **Só capturar o que usar, esquecer o que evitar.** Saber o que a pessoa NUNCA diria é metade do valor.
+
+4. **Ignorar humor.** Humor é o maior diferenciador de conteúdo. Sempre capturar.
+
+5. **Material insuficiente.** 1 post não define voz. Mínimo 3-5 peças, ideal 10-20.
+
+6. **Não validar com o usuário.** Voz capturada errada contamina todo conteúdo. Sempre validar antes de usar.
+
+7. **Confundir voz pessoal com voz de marca.** Definir qual antes de extrair.
+
+8. **Arquivos que outras skills não conseguem consumir.** Sempre estruturar pra reuso.
+
+9. **Capturar voz de material que não é da pessoa.** E-mail template, texto de agência, post ghostwritten — não é a voz real.
+
+10. **Não atualizar.** Voz evolui. Material novo refina os arquivos.
+
+## Edge cases
+
+**Cliente não tem material escrito:**
+Pedir pra gravar 2-3 áudios falando sobre o negócio (transcrever) ou fazer entrevista por perguntas. Voz falada transcrita é excelente fonte.
+
+**Cliente quer voz diferente da atual:**
+Possível. Em vez de extrair voz atual, construir voz-alvo a partir de referências (outras marcas que admira) + ajustes. Documentar que é voz aspiracional, não atual.
+
+**Marca com múltiplos produtos/públicos:**
+Pode precisar de variações de voz por contexto (B2B formal vs B2C descontraído). Documentar as variações.
+
+**Cliente institucional sem personalidade definida:**
+Oportunidade de construir do zero. Workshop de posicionamento: como queremos soar? Quem admiramos? O que evitar? Construir os arquivos como decisão estratégica.
+
+**Voz inconsistente no material (pessoa escreve diferente em contextos):**
+Identificar o denominador comum + documentar variações por contexto (LinkedIn formal vs WhatsApp solto).
+
+**Material em outro idioma:**
+Se a pessoa escreve em PT mas tem material em EN, extrair padrões transferíveis (humor, crenças) e adaptar vocabulário pro PT.
+
+## Conexão com outras skills ZARK
+
+- **`seo-content-writer-br`** (8): consumidor PRINCIPAL. Toda peça referencia a voz.
+- **`gbp-optimizer`** (3): descrição e posts autênticos.
+- **`review-acquisition-engine`** (9): respostas humanas.
+- **`service-area-page-builder`** (4): páginas com personalidade.
+- **`topical-authority-architect`** (7): consistência de voz no cluster.
+- **`seo-orchestrator`**: aciona essa skill no início de qualquer projeto de conteúdo.
+
+**Posição no pipeline:** essa skill roda UMA VEZ no início (ou quando há material novo), e seus outputs alimentam toda produção subsequente. É pré-requisito de qualidade pra produção de conteúdo em volume.
+
+## Exemplo de invocação esperada
+
+**Usuário:** "Quero que os posts da Gerais soem como eu escrevo, não como IA genérica"
+
+**Resposta esperada:** acionar essa skill, pedir material (posts, mensagens, áudios do dono da Gerais), extrair os 5 arquivos, validar, instruir como usar nas próximas produções.
+
+**Usuário:** "Capturar a voz da marca pra padronizar a comunicação"
+
+**Resposta esperada:** acionar essa skill, identificar se é personal brand ou institucional, coletar material apropriado, gerar referências, validar.
+
+**Usuário:** "Meu conteúdo tá com cara de ChatGPT, como resolvo?"
+
+**Resposta esperada:** acionar essa skill, explicar que a solução é capturar a voz real, pedir material onde a pessoa soa autêntica, extrair e codificar, conectar com a Skill 8 pra produção futura.
+
+**Usuário:** "Tenho 10 posts de LinkedIn, extrai meu tom de voz"
+
+**Resposta esperada:** acionar essa skill, analisar os 10 posts nas 5 dimensões, gerar os arquivos de referência, validar com o usuário.

package/templates/citations-builder-br-SKILL.md

@@ -84,10 +84,10 @@ Antes de tudo, definir a **ficha-mestra NAP**. Esse é o documento sagrado — t
 ```
 Nome: Limppetec Limpeza Profissional
 Razão social: Limppe Tec Limpeza Mecanizada Ltda
-CNPJ: 44.053.797/0001-60
+CNPJ: 00.000.000/0001-00
 Endereço: Avenida Francisco Firmo de Matos, 588, Loja, Riacho das Pedras, Contagem - MG, 32280-270
-Telefone: (31) 2116-1615
-WhatsApp: (31) 2116-1615
+Telefone: (11) 99999-9999
+WhatsApp: (11) 99999-9999
 E-mail: contato@limppetec.com.br
 Site: https://limppetec.com.br
 Horário: Segunda a Sexta 07:30-17:30 | Sábado 07:30-12:00