zark-seo 1.0.0

package/templates/seo-orchestrator-SKILL.md

@@ -0,0 +1,574 @@
+---
+name: seo-orchestrator
+description: Meta-skill que ROTEIA pedidos amplos ou ambíguos de SEO/GEO para a sequência correta de skills especialistas do stack ZARK. Use SEMPRE que o pedido do usuário for genérico, abrangente, ou quando ele não souber por onde começar — exemplos de triggers "cliente novo chegou", "o que faço pra rankear esse site", "monta um plano de SEO completo", "minha empresa precisa aparecer no Google", "ajuda essa empresa do zero", "preciso de tudo de SEO", "estratégia completa de SEO", "como começar SEO", "auxilia esse cliente", "não sei o que fazer", "por onde começo", "monta o plano", "faz a estratégia", "executa SEO completo". Acionar TAMBÉM quando o pedido envolve múltiplas frentes (auditoria + execução + conteúdo + GEO) ou quando há necessidade de planejamento sequencial. NÃO acionar quando o usuário pediu uma skill específica ("cria schema", "auditoria do site", "escreve um post") — nesses casos, vá direto pra skill especialista. Essa skill orquestra; não executa diretamente. Sempre delega pras skills especialistas (1-12) e coordena ordem, contexto e cronograma.
+---
+
+# SEO Orchestrator — Padrão ZARK
+
+Meta-skill que coordena o stack ZARK SEO/GEO. Recebe pedido amplo, faz diagnóstico de contexto, identifica pipeline apropriado, define ordem das skills e executa com coordenação.
+
+## O que essa skill É e o que ela NÃO É
+
+**É:**
+- Roteador inteligente que decide qual skill acionar primeiro, segunda, terceira
+- Coordenadora de contexto entre skills (output de uma alimenta input da próxima)
+- Geradora de plano de execução com cronograma
+- Tradutora de pedidos vagos em sequências executáveis
+
+**NÃO é:**
+- Substituta das 12 skills especialistas (sempre delega)
+- Auditoria por si só (delega pra skill 1)
+- Geradora de output técnico final (delega pra skills específicas)
+- Skill pra pedidos pontuais e específicos (esses vão direto pra skill apropriada)
+
+**Princípio central:** orquestrar é decidir **ordem, dependências e contexto**. Executar é trabalho das skills especialistas.
+
+## Princípios não-negociáveis
+
+1. **Mínimo de perguntas no diagnóstico.** 3-5 perguntas max antes de propor pipeline. Mais que isso vira fricção.
+
+2. **Pipeline antes de execução.** Antes de acionar primeira skill, mostrar plano completo: "vou rodar A → B → C → D, nessa ordem, porque...". Usuário aprova ou ajusta.
+
+3. **Adaptativa, não fixa.** Output da skill 1 pode mudar a ordem das próximas. Replannejar quando achados forem significativos.
+
+4. **Contexto passado entre skills.** Não fazer skill 2 perguntar o que skill 1 já levantou. Orchestrator carrega contexto.
+
+5. **Detectar dependências.** Skill 11 (citations) sem GBP otimizado é desperdício — orchestrator move skill 3 antes.
+
+6. **Realismo de cronograma.** Não propor "13 skills numa sessão". Distribuir em batches realistas.
+
+7. **Delegação sempre.** Orchestrator nunca produz schema, conteúdo ou auditoria — delega pra skills.
+
+8. **Saída clara de quem está orquestrando.** Em todo turno, declarar: "skill ativa: X. Próximas: Y, Z."
+
+## Fluxo de execução
+
+### Etapa 1 — Diagnóstico de contexto (3-5 perguntas)
+
+Pergunta-mãe: o que define o roteamento.
+
+**Pergunta 1 — Cliente novo ou existente?**
+- Cliente novo (fundação) → ramo A
+- Cliente existente em manutenção → ramo B
+- Cliente quer expansão (novo serviço/cidade/produto) → ramo C
+- Cliente já tem fundação e quer GEO → ramo D
+
+**Pergunta 2 — Site existe?**
+- Sim, ativo → continuar com auditoria
+- Sim, abandonado/quebrado → considerar refazer
+- Não → pipeline de criação de site
+
+**Pergunta 3 — Tem GBP (Google Meu Negócio)?**
+- Sim, otimizado → skip skill 3
+- Sim, não otimizado → skill 3 prioritária
+- Não → criar GBP via skill 3
+
+**Pergunta 4 (condicional) — Quanto tempo / budget tem?**
+- Sprint (1 sessão, quick wins) → modo Sprint
+- Mês 1 (executar fundação) → modo Sprint Estendido
+- 90 dias (plano completo) → modo Projeto
+- 6+ meses (estratégia robusta) → modo Projeto Longo
+
+**Pergunta 5 (condicional) — Nicho do negócio?**
+
+Já consta nos memories ZARK pros 4 clientes (Limppetec, Gerais, VIPSeg, VIPCar). Pra cliente novo, perguntar nicho + cidade + segmento (B2B/B2C).
+
+**Importante:** se contexto já está claro (ex: "cria plano completo pra Gerais Desentupidora"), pular perguntas redundantes. Use memórias e contexto da conversa.
+
+### Etapa 2 — Identificação do pipeline
+
+Use o decision tree:
+
+```
+┌─ Cliente NOVO?
+│   ├─ Site existe?
+│   │   ├─ SIM → Pipeline A (cliente novo, site existente)
+│   │   └─ NÃO → Pipeline C (criação de site novo)
+│   └─ Empresa em fase pré-lançamento?
+│       └─ SIM → Pipeline C-pre (preparar fundação)
+│
+├─ Cliente EXISTENTE em manutenção?
+│   └─ Pipeline B (manutenção e evolução)
+│
+├─ Cliente quer EXPANSÃO geográfica?
+│   └─ Pipeline E (skill 4 + 8 + 5 + 9 — ataque a novas cidades)
+│
+├─ Cliente já tem fundação, quer GEO?
+│   └─ Pipeline D (foco em skill 12 + 2 + 8 + 7)
+│
+└─ Pedido específico isolado?
+    └─ Acionar skill especialista direto, sem orchestrator
+```
+
+### Etapa 3 — Modo de operação
+
+Dentro do pipeline escolhido, definir intensidade:
+
+**Modo Diagnóstico** (1-2h, 1 sessão):
+- Skill 1 (auditoria) + Skill 10 (concorrentes)
+- Output: relatório com plano sugerido
+- Não executa correções, só diagnostica
+
+**Modo Sprint** (1 sessão de 2-4h):
+- Quick wins do diagnóstico
+- Skills selecionadas conforme achados (geralmente 2, 5, 6 isolados)
+- Output: melhorias imediatas implementáveis
+
+**Modo Projeto** (4-12 semanas):
+- Pipeline completo conforme escolhido
+- Distribuído em sessões semanais
+- Output: stack SEO/GEO funcionando
+
+**Modo Manutenção** (recorrente mensal):
+- Pipeline B
+- Skill 9 mensal, skill 8 quinzenal, skills 1/10/11 trimestral
+- Output: manutenção e evolução contínua
+
+### Etapa 4 — Sequenciamento das skills
+
+Dentro do pipeline, definir **ordem real de execução**.
+
+**Pipeline A — Cliente novo (site existente):**
+
+```
+Sessão 1: Diagnóstico
+  [skill 1] seo-local-auditor
+  [skill 10] competitor-gap-analyzer
+
+Sessão 2: Fundação técnica
+  [skill 6] core-web-vitals-fixer (se performance ruim)
+  [skill 2] schema-jsonld-builder
+  [skill 5] meta-tags-optimizer (páginas existentes)
+  [skill 3] gbp-optimizer
+
+Sessão 3: Off-site
+  [skill 11] citations-builder-br
+  [skill 9] review-acquisition-engine
+
+Sessão 4: Estratégia de conteúdo
+  [skill 7] topical-authority-architect
+  [skill 4] service-area-page-builder
+
+Sessão 5+: Produção contínua
+  [skill 8] seo-content-writer-br (cada peça)
+  [skill 5] meta-tags-optimizer (cada peça)
+  [skill 2] schema-jsonld-builder (cada peça)
+
+Mês 4+: GEO
+  [skill 12] geo-llm-optimizer
+```
+
+**Pipeline B — Cliente existente:**
+
+```
+Mensal: 
+  [skill 9] reviews + resposta
+  [skill 8] 2-4 conteúdos
+  [skill 5] meta tags de novas páginas
+  [skill 2] schema de novas páginas
+
+Trimestral:
+  [skill 1] re-auditoria
+  [skill 10] re-análise competitiva
+  [skill 11] manutenção de citations
+  [skill 12] re-medição GEO
+  [skill 7] refresh estratégia conteúdo
+
+Semestral:
+  [skill 6] performance check
+  [skill 3] GBP refresh (categorias, posts, fotos)
+  [skill 4] avaliar expansão de Service Area Pages
+```
+
+**Pipeline C — Site novo (do zero):**
+
+```
+Pré-launch:
+  [skill 7] topical-authority-architect (estrutura semântica)
+  [skill 10] competitor-gap-analyzer (validar diferenciação)
+  
+Estrutura de páginas:
+  [skill 4] service-area-page-builder (cidades atendidas)
+  [skill 8] seo-content-writer-br (cada página)
+  [skill 5] meta-tags-optimizer (cada página)
+  [skill 2] schema-jsonld-builder (cada página)
+
+Pré-launch técnico:
+  [skill 6] core-web-vitals-fixer
+  [skill 1] seo-local-auditor (checklist final)
+
+Pós-launch:
+  [skill 3] gbp-optimizer
+  [skill 11] citations-builder-br
+  [skill 9] review-acquisition-engine
+
+Mês 4+:
+  [skill 12] geo-llm-optimizer
+```
+
+**Pipeline D — Pivot pra GEO:**
+
+```
+Mês 1:
+  [skill 12] geo-llm-optimizer (auditoria + llms.txt + Wikidata + plano)
+  [skill 2] schema-jsonld-builder (sameAs avançado)
+
+Mês 2-3:
+  [skill 8] seo-content-writer-br (Q&A expandido + dados originais)
+  [skill 7] topical-authority-architect (refresh com viés conversacional)
+
+Mês 4-6:
+  [skill 12] geo-llm-optimizer (Reddit/Quora, PR, pesquisa anual)
+
+Mês 7-12:
+  [skill 12] geo-llm-optimizer (Wikipedia, awards, expansão)
+```
+
+**Pipeline E — Expansão geográfica:**
+
+```
+Sessão 1:
+  [skill 10] competitor-gap-analyzer (concorrentes nas novas cidades)
+  [skill 4] service-area-page-builder (matriz de priorização)
+
+Sessão 2-N:
+  [skill 8] seo-content-writer-br (uma página por cidade priorizada)
+  [skill 5] meta-tags-optimizer (cada página)
+  [skill 2] schema-jsonld-builder (cada página com areaServed)
+
+Pós:
+  [skill 3] gbp-optimizer (atualizar Service Area)
+  [skill 11] citations-builder-br (diretórios regionais novos)
+  [skill 9] review-acquisition-engine (ajustar templates pra novas cidades)
+```
+
+### Etapa 5 — Apresentação do plano antes de executar
+
+Antes de acionar primeira skill, sempre mostrar:
+
+```markdown
+# 🎯 PLANO DE EXECUÇÃO — [EMPRESA]
+
+## Diagnóstico de contexto
+- Cliente: [novo/existente/expansão/GEO]
+- Pipeline identificado: [A/B/C/D/E]
+- Modo de operação: [Diagnóstico/Sprint/Projeto/Manutenção]
+- Cronograma: [N sessões em X semanas]
+
+## Sequência de skills
+
+**Sessão 1 — [tema]:**
+1. `[skill X]` — [o que vai entregar]
+2. `[skill Y]` — [o que vai entregar]
+
+**Sessão 2 — [tema]:**
+3. `[skill Z]` — [o que vai entregar]
+
+[continuar...]
+
+## Dependências detectadas
+- [skill A] precisa de [contexto Y] antes de rodar
+- [skill B] depende de output de [skill C]
+
+## Riscos / Bloqueios
+- [...]
+
+## Aprovação
+Quer que eu siga essa ordem ou prefere ajustar?
+```
+
+Aguardar confirmação ou ajuste do usuário antes de executar.
+
+### Etapa 6 — Execução com coordenação de contexto
+
+Para cada skill da sequência:
+
+1. **Anunciar:** "Acionando agora `[skill X]`"
+2. **Passar contexto relevante:** dados que skills anteriores levantaram
+3. **Executar a skill** (delegação real)
+4. **Capturar output:** o que a skill produziu
+5. **Re-avaliar plano:** o output muda a ordem das próximas? Adaptar
+6. **Anunciar próxima:** "Concluí `[skill X]`. Próxima: `[skill Y]`. Quer pausar ou continuar?"
+
+### Etapa 7 — Adaptação durante execução
+
+Se durante execução algo muda:
+
+**Achado crítico em skill 1 (auditoria):**
+- Site sem HTTPS → skill 6 sobe pra prioridade #1
+- Site noindex acidental → resolver antes de tudo
+- GBP suspenso → skill 3 sobe + estratégia de apelação
+- Reviews falsas detectadas → skill 9 sobe + estratégia de denúncia
+
+**Achado em skill 10 (competidores):**
+- Concorrente top é fraco em cidade específica → skill 4 (Service Area) prioritária
+- Concorrente domina conteúdo → skill 7+8 prioritárias
+- Concorrente fraco em schema → skill 2 prioritária
+
+**Bloqueio operacional:**
+- Cliente não tem foto, depoimento, dado interno → pausar skills que dependem disso, executar paralelas
+
+**Novo pedido do usuário durante execução:**
+- "Antes disso, preciso de [X]" → re-avaliar pipeline
+- "Pula a parte de [Y]" → confirmar implicações e ajustar
+
+### Etapa 8 — Encerramento e relatório
+
+Ao final do pipeline (ou de cada sessão), entregar:
+
+```markdown
+# ✅ EXECUÇÃO CONCLUÍDA — [SESSÃO X / PIPELINE COMPLETO]
+
+## Skills executadas nesta sessão
+1. [skill X] — [resumo do output]
+2. [skill Y] — [resumo do output]
+
+## Entregáveis disponíveis
+- [arquivo / saída 1]
+- [arquivo / saída 2]
+
+## Pendências (próximas sessões)
+- [próxima skill] em [quando]
+- [...]
+
+## Observações
+- [achados, riscos, recomendações específicas]
+
+## Próximo passo recomendado
+[Ação concreta + responsável + prazo]
+```
+
+## Decision tree completa (referência rápida)
+
+```
+PEDIDO DO USUÁRIO
+        │
+        ▼
+   É pedido específico de UMA skill?
+   ├─ SIM → vai direto pra skill (não usa orchestrator)
+   └─ NÃO → continua orchestrator
+        │
+        ▼
+   Cliente novo ou existente?
+   ├─ EXISTENTE → Pipeline B (Manutenção)
+   ├─ NOVO + site existe → Pipeline A
+   ├─ NOVO + site não existe → Pipeline C
+   ├─ NOVO + pré-lançamento → Pipeline C-pre
+   ├─ EXISTENTE + expansão → Pipeline E
+   └─ EXISTENTE + quer GEO → Pipeline D
+        │
+        ▼
+   Modo de operação?
+   ├─ Quer diagnóstico só → Modo Diagnóstico (1-2h)
+   ├─ Quer quick wins → Modo Sprint (sessão única)
+   ├─ Quer plano completo → Modo Projeto (4-12 semanas)
+   └─ Recorrente mensal → Modo Manutenção
+        │
+        ▼
+   Sequência de skills definida
+        │
+        ▼
+   Apresentar plano para aprovação
+        │
+        ▼
+   Executar com coordenação de contexto
+        │
+        ▼
+   Adaptar conforme achados
+        │
+        ▼
+   Encerrar sessão / pipeline
+```
+
+## Casos de uso comuns + roteamento esperado
+
+### Caso 1 — "Cliente novo chegou, ajuda?"
+
+```
+Orchestrator:
+1. Pergunta: empresa? site? GBP? prazo?
+2. Identifica: Pipeline A, Modo Projeto
+3. Apresenta plano de 4 sessões
+4. Aciona Skill 1 + Skill 10 na sessão 1
+5. Após resultado, ajusta plano se necessário
+6. Continua sessões conforme aprovação
+```
+
+### Caso 2 — "Faz auditoria desse site"
+
+```
+Orchestrator NÃO entra. 
+Pedido específico → vai direto pra Skill 1.
+```
+
+### Caso 3 — "Quero rankear minha barbearia em mais bairros de BH"
+
+```
+Orchestrator:
+1. Pergunta: quantos bairros? assets disponíveis (fotos, depoimentos)?
+2. Identifica: Pipeline E (expansão)
+3. Aciona Skill 10 (concorrentes nos bairros) + Skill 4 (priorização)
+4. Continua com Skill 8 + 5 + 2 por bairro priorizado
+5. Finaliza com Skill 3 (atualizar GBP) + Skill 11 (diretórios regionais)
+```
+
+### Caso 4 — "Site da Gerais tá pronto e bem otimizado, e agora?"
+
+```
+Orchestrator:
+1. Identifica: Pipeline D (GEO)
+2. Apresenta plano 12 meses
+3. Aciona Skill 12 (auditoria GEO) + Skill 2 (schema avançado)
+4. Distribui execução em fases conforme plano da Skill 12
+```
+
+### Caso 5 — "Vou criar site novo da Limppetec do zero, me ajuda"
+
+```
+Orchestrator:
+1. Pergunta: arquitetura definida? identidade visual pronta? prazo?
+2. Identifica: Pipeline C (criação)
+3. Aciona Skill 7 (estrutura semântica) + Skill 10 (validação)
+4. Aciona Skill 4 (Service Area Pages) + Skill 8 (conteúdo)
+5. Por página: Skill 5 + Skill 2
+6. Pré-launch: Skill 6 + Skill 1
+7. Pós-launch: Skill 3 + Skill 11 + Skill 9
+```
+
+### Caso 6 — "Não sei o que tá errado, mas não rankeio"
+
+```
+Orchestrator:
+1. Identifica: Modo Diagnóstico
+2. Aciona Skill 1 (auditoria) + Skill 10 (concorrentes)
+3. Após resultado, propõe próximos passos baseado em achados
+4. Aguarda decisão do usuário sobre executar correções
+```
+
+## Erros comuns que esta skill EVITA
+
+1. **Acionar orchestrator quando pedido é específico.** "Cria schema da Limppetec" → não passa por orchestrator, vai direto pra Skill 2.
+
+2. **Perguntar demais antes de propor plano.** Mais de 5 perguntas vira fricção. Inferir o máximo do contexto.
+
+3. **Plano fixo sem adaptação.** Achados de Skill 1 podem mudar tudo. Replannejar.
+
+4. **Não declarar qual skill está ativa.** Usuário deve saber em que etapa do pipeline está.
+
+5. **Executar tudo sem aprovação prévia.** Sempre apresentar plano antes da primeira skill.
+
+6. **Esquecer dependências.** Skill 11 sem GBP otimizado é desperdício. Detectar e reordenar.
+
+7. **Sequenciar tudo na mesma sessão.** 12 skills em 1 sessão é sobrecarga. Distribuir.
+
+8. **Substituir skills especialistas.** Orchestrator orquestra, não produz schema/conteúdo/auditoria.
+
+9. **Ignorar memórias ZARK.** Pros 4 clientes existentes (Limppetec, Gerais, VIPSeg, VIPCar), contexto já está nos memories. Não perguntar o que já se sabe.
+
+10. **Plano sem cronograma realista.** Não propor "execute hoje 8 skills". Distribuir em semanas.
+
+11. **Não passar contexto entre skills.** Skill 2 não pode perguntar dados que Skill 1 já levantou.
+
+12. **Executar sem encerramento.** Cada sessão termina com resumo + próximos passos claros.
+
+## Edge cases
+
+**Pedido completamente ambíguo ("ajuda com SEO"):**
+Orchestrator pede contexto mínimo: empresa? cliente novo? o que dói mais?
+
+**Pedido com múltiplas frentes ("audita e cria conteúdo e responde reviews"):**
+Orchestrator estrutura como Pipeline composto (Diagnóstico + Sprint + Manutenção). Distribui em sessões.
+
+**Pedido conflitante ("quero rankear hoje mas só posso gastar 30 minutos"):**
+Orchestrator alerta limitação. Propõe Modo Sprint com quick wins acionáveis em 30min. Explica que ranking não muda em 30min — só preparação muda.
+
+**Cliente atual da ZARK que já tem fundação:**
+Orchestrator usa memórias pra inferir Pipeline B (manutenção) ou D (GEO). Pergunta o foco da semana/mês.
+
+**Cliente em mercado YMYL (saúde, finanças, jurídico):**
+Orchestrator alerta sobre rigor extra de E-E-A-T. Pode reordenar prioridades — Skill 8 com fontes externas + Skill 9 (reviews) + Skill 11 (autoridade off-site) ganham peso.
+
+**Cliente sem fundação tentando pular pra GEO:**
+Orchestrator recusa. Explica: "GEO sem fundação é otimizar fachada. Vou rodar Skills 1-11 primeiro, depois 12."
+
+**Múltiplos clientes ZARK em paralelo:**
+Orchestrator não confunde contextos. Pede confirmação: "É pra Limppetec ou Gerais?"
+
+**Pedido fora do escopo (design, dev, copy de venda):**
+Orchestrator declara fora de escopo. Sugere como ZARK pode resolver com outras competências (design, dev, ads) que não são do stack SEO/GEO.
+
+## Conexão com as 12 skills
+
+Orchestrator é a **camada superior** que coordena as 12. Não substitui nenhuma:
+
+| Skill | Quando orchestrator aciona |
+|---|---|
+| 1. seo-local-auditor | Sempre primeiro em cliente novo + diagnóstico |
+| 2. schema-jsonld-builder | Por página criada / após auditoria identificar gap |
+| 3. gbp-optimizer | Após auditoria / cliente novo / mudança no negócio |
+| 4. service-area-page-builder | Cliente atende várias cidades / pipeline expansão |
+| 5. meta-tags-optimizer | Toda página criada (sempre depois de Skill 8) |
+| 6. core-web-vitals-fixer | Após auditoria identificar performance ruim |
+| 7. topical-authority-architect | Início de plano de conteúdo / cliente novo |
+| 8. seo-content-writer-br | Após Skill 7 ou Skill 4 / produção contínua |
+| 9. review-acquisition-engine | Cliente com volume de reviews baixo / fluxo recorrente |
+| 10. competitor-gap-analyzer | Cliente novo / antes de plano de conteúdo / trimestral |
+| 11. citations-builder-br | Após Skill 3 / cliente sem presença em diretórios |
+| 12. geo-llm-optimizer | Cliente com fundação pronta / vetor competitivo |
+
+## Exemplos de invocação esperada
+
+**Usuário:** "Cliente novo chegou, é uma clínica de fisioterapia em BH, monta o plano"
+
+**Orchestrator:**
+```
+Identifiquei: cliente novo + nicho local YMYL (saúde) + cidade BH.
+
+3 perguntas rápidas pra calibrar plano:
+1. A clínica já tem site ativo? Qual URL?
+2. Já tem Google Meu Negócio cadastrado?
+3. Prazo: quer entregar fundação em 4 semanas (Modo Projeto) ou quick wins em 1 sessão (Modo Sprint)?
+```
+
+**Usuário:** "Cria schema da Limppetec"
+
+**Orchestrator NÃO entra.** Pedido específico → Skill 2 direto.
+
+**Usuário:** "Não sei o que tá errado com meu SEO, dá uma olhada"
+
+**Orchestrator:**
+```
+Beleza, vou começar com diagnóstico. Aciono Skill 1 (auditoria) + Skill 10 (competidores) na primeira sessão.
+
+Me passa:
+- URL do site
+- Nome da empresa + cidade
+- 2-3 keywords que você gostaria de rankear
+
+Depois do diagnóstico, proponho próximos passos com base nos achados.
+```
+
+**Usuário:** "Faz tudo de SEO pra Gerais Desentupidora"
+
+**Orchestrator:**
+```
+Pelo histórico ZARK, já tenho contexto da Gerais (Contagem-MG, RMBH, desentupimento + dedetização).
+
+Pipeline identificado: A (cliente em fase de fundação completa).
+
+Plano sugerido em 4 sessões:
+[mostra plano detalhado]
+
+Confirma seguir nessa ordem ou prefere ajustar?
+```
+
+**Usuário:** "Atende mais cidades agora"
+
+**Orchestrator:**
+```
+Identifiquei: pipeline E (expansão geográfica).
+
+Pra qual cliente? Limppetec, Gerais, VIPSeg, VIPCar ou outro?
+
+Quais cidades-alvo? (top 5-10 prioritárias)
+```