zark-seo 1.0.0 → 1.1.0

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}/\` — 13 skills especialistas (1 orquestrador + 12 especialistas) em SEO Local, 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}/\` — 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 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 13 skills SEO/GEO (default: ./seo-skills)`);
+  console.log(`    ${c.green('init')} ${c.dim('[pasta]')}   instala 14 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,14 +87,14 @@ 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(`    13 skills (1 orquestrador + 12 especialistas) em SEO Local, conteúdo e GEO.`);
+  console.log(`    14 skills (1 orquestrador + 13 especialistas) em SEO Local, técnico, conteúdo e GEO.`);
   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('Técnico:')}       schema-jsonld-builder · meta-tags-optimizer · core-web-vitals-fixer`);
+  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('Off-site:')}      review-acquisition-engine`);
   console.log(`    ${c.dim('LLM/GEO:')}       geo-llm-optimizer ★\n`);
@@ -147,7 +147,7 @@ async function runInit(args) {
   }
 
   console.log('');
-  console.log(c.green(`✓ 13 skills instaladas em ${skillsDirName}/`));
+  console.log(c.green(`✓ 14 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,7 +1,7 @@
 {
   "name": "zark-seo",
-  "version": "1.0.0",
-  "description": "ZARK SEO & GEO Skills Stack — install via `npx zark-seo init` to drop 13 SEO/GEO specialist skills (Local SEO, content, GEO/LLM optimization) as REFERENCE for AI in any project. Brazilian market focus, derived from real ZARK audits.",
+  "version": "1.1.0",
+  "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": {
     "zark-seo": "bin/cli.js"

package/templates/README.md

@@ -1,6 +1,6 @@
 # 🚀 ZARK SEO & GEO Skills Stack
 
-Stack completo de 12 skills especialistas em SEO Local, 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 **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.
 
 > **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,6 +22,7 @@ Stack completo de 12 skills especialistas em SEO Local, SEO de conteúdo e GEO (
 | 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" |
 
 ★ = moat competitivo ZARK em 2026
 
@@ -37,7 +38,8 @@ 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)
                        │
-Semana 2-3   ┌─ 3. gbp-optimizer               (60% do ranking Local)
+Semana 2-3   ┌─ 13. seo-technical-engineer    (fundação técnica: indexação, rendering, sitemap)
+             ├─ 3. gbp-optimizer               (60% do ranking Local)
              ├─ 2. schema-jsonld-builder       (fundação de entidade)
              └─ 6. core-web-vitals-fixer       (performance se aplicável)
                        │
@@ -65,6 +67,7 @@ Trimestral    ─ 1. seo-local-auditor            (re-auditoria)
               ─ 10. competitor-gap-analyzer     (mercado mudou)
               ─ 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)
 
 Semestral     ─ 6. core-web-vitals-fixer        (validar performance)
               ─ 7. topical-authority-architect  (refresh de estratégia)
@@ -84,7 +87,8 @@ Estrutura     ┌─ 4. service-area-page-builder   (páginas de cidade)
 Por página    ┌─ 5. meta-tags-optimizer         (title/desc/OG)
               └─ 2. schema-jsonld-builder       (schema apropriado)
                        │
-Pré-launch    ┌─ 6. core-web-vitals-fixer       (validar performance)
+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)
@@ -114,7 +118,13 @@ Mês 7-12      └─ 12. geo-llm-optimizer          (Wikipedia se elegível, aw
 
 | Cliente disse... | Skill principal | Skills complementares |
 |---|---|---|
-| "Meu site não aparece no Google" | 1 | 3, 6, 11 |
+| "Meu site não aparece no Google" | 13 | 1, 3, 6 |
+| "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 |
 | "Preciso de mais reviews" | 9 | 3 |

package/templates/seo-orchestrator-SKILL.md

@@ -1,6 +1,6 @@
 ---
 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.
+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-13) e coordena ordem, contexto e cronograma.
 ---
 
 # SEO Orchestrator — Padrão ZARK
@@ -16,7 +16,7 @@ Meta-skill que coordena o stack ZARK SEO/GEO. Recebe pedido amplo, faz diagnóst
 - Tradutora de pedidos vagos em sequências executáveis
 
 **NÃO é:**
-- Substituta das 12 skills especialistas (sempre delega)
+- Substituta das 13 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)
@@ -35,7 +35,7 @@ Meta-skill que coordena o stack ZARK SEO/GEO. Recebe pedido amplo, faz diagnóst
 
 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.
+6. **Realismo de cronograma.** Não propor "14 skills numa sessão". Distribuir em batches realistas.
 
 7. **Delegação sempre.** Orchestrator nunca produz schema, conteúdo ou auditoria — delega pra skills.
 
@@ -136,6 +136,7 @@ Sessão 1: Diagnóstico
   [skill 10] competitor-gap-analyzer
 
 Sessão 2: Fundação técnica
+  [skill 13] seo-technical-engineer (indexação, rendering, robots/sitemap)
   [skill 6] core-web-vitals-fixer (se performance ruim)
   [skill 2] schema-jsonld-builder
   [skill 5] meta-tags-optimizer (páginas existentes)
@@ -172,6 +173,7 @@ Trimestral:
   [skill 10] re-análise competitiva
   [skill 11] manutenção de citations
   [skill 12] re-medição GEO
+  [skill 13] re-check técnico (GSC, indexação, redirects)
   [skill 7] refresh estratégia conteúdo
 
 Semestral:
@@ -194,6 +196,7 @@ Estrutura de páginas:
   [skill 2] schema-jsonld-builder (cada página)
 
 Pré-launch técnico:
+  [skill 13] seo-technical-engineer (robots/sitemap/rendering/redirects)
   [skill 6] core-web-vitals-fixer
   [skill 1] seo-local-auditor (checklist final)
 
@@ -497,9 +500,9 @@ Orchestrator não confunde contextos. Pede confirmação: "É pra Limppetec ou G
 **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
+## Conexão com as 13 skills
 
-Orchestrator é a **camada superior** que coordena as 12. Não substitui nenhuma:
+Orchestrator é a **camada superior** que coordena as 13. Não substitui nenhuma:
 
 | Skill | Quando orchestrator aciona |
 |---|---|
@@ -515,6 +518,7 @@ Orchestrator é a **camada superior** que coordena as 12. Não substitui nenhuma
 | 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 |
+| 13. seo-technical-engineer | Indexação travada, JS SEO, migração de domínio, GSC errors, pré-launch de site novo, re-check trimestral técnico |
 
 ## Exemplos de invocação esperada
 

package/templates/seo-technical-engineer-SKILL.md

@@ -0,0 +1,907 @@
+---
+name: seo-technical-engineer
+description: SEO técnico avançado para sites, sistemas web e aplicações — diagnostica e corrige problemas de indexação, crawlability, renderização (JavaScript SEO), arquitetura de URL, redirecionamentos, migrações de domínio, sitemap.xml, robots.txt, hreflang, canonical, paginação, faceted navigation, Search Console issues, e tudo que envolve fazer um sistema ser rastreado, renderizado e indexado corretamente pelo Google. Use SEMPRE que o usuário pedir para "site não indexa", "Google não acha minha página", "problema no Search Console", "erro de indexação", "robots.txt", "sitemap.xml", "canonical", "redirect 301", "migrar domínio", "mudar de HTTP para HTTPS", "site React não rankeia", "JavaScript SEO", "site Next.js", "SSR vs SSG", "rendering", "Soft 404", "Crawled not indexed", "Discovered not indexed", "página com redirect", "noindex", "hreflang", "paginação SEO", "filtros não rankeiam", "ecommerce indexação", "URLs com parâmetros", "trailing slash", "www vs non-www", "log file analysis", "Googlebot", "crawl budget", "site grande não indexa todas as páginas", "disavow", "manual action", "penalidade", "recovery", "estrutura de URL", "arquitetura de site", "depth de cliques", "internal linking técnico", "soft 404", "x-robots-tag", "HTTP headers SEO". Acionar também quando outras skills (1, 6, 2) detectarem gargalo técnico que exige aprofundamento. Trabalha como engenheiro de SEO sênior — entrega diagnóstico técnico em camadas e código pronto pra colar em servidor (nginx, apache, htaccess, next.config.js, robots.txt, sitemap).
+---
+
+# SEO Technical Engineer — Padrão ZARK
+
+Skill de SEO técnico avançado pra sites, sistemas e aplicações web. Trabalha como engenheiro de SEO sênior — diagnostica em camadas, corrige na raiz, e produz código pronto pra colar em produção.
+
+## Por que essa skill existe
+
+SEO técnico é **fundação invisível**. Cliente que tem GBP perfeito, conteúdo excelente, schema completo e reviews ótimas — mas tem `robots.txt` bloqueando o site, `noindex` acidental, ou JavaScript não renderizando pro Googlebot — **não rankeia nada**. Os 13 skills anteriores otimizam superfície; essa skill otimiza fundação.
+
+Em 2026, com a popularização de frameworks JavaScript (React, Vue, Next.js, Angular, Svelte), sistemas SaaS, e e-commerces complexos, problemas técnicos de SEO viraram o **maior bloqueador silencioso** de ranking. Site que parece "ok" pra humano frequentemente é incompreensível pro Googlebot.
+
+## Princípios não-negociáveis
+
+1. **Diagnóstico em 5 camadas antes de prescrição.** Acessibilidade → Crawlability → Renderability → Indexability → Rankability. Pular camada gera fix superficial.
+
+2. **Inspeção real, não suposição.** Skill executa `curl -I`, simula Googlebot, verifica robots.txt, lê sitemap, busca `site:` no Google. Não inventa diagnóstico.
+
+3. **Código pronto pra colar.** Output não é "ajuste seu robots.txt" — é o conteúdo exato do robots.txt pra esse caso.
+
+4. **Reconhecer limites.** Sem acesso ao servidor, algumas coisas não dão pra resolver. Skill instrui o que pedir ao dev/hospedagem.
+
+5. **JavaScript SEO requer rigor.** Site React/Vue/Next/Angular renderizando client-side é caso especial. Skill diagnostica modo de renderização.
+
+6. **Migrações exigem plano de rollback.** Migração mal feita destrói anos de ranking. Skill nunca migra sem checklist + monitoramento.
+
+7. **Search Console é a fonte de verdade.** Cliente sem acesso ao GSC é cego. Skill instrui setup primeiro, antes de diagnóstico profundo.
+
+8. **Cada framework tem armadilhas próprias.** WordPress + Elementor difere de Next.js que difere de Shopify. Skill conhece cada um.
+
+9. **Honestidade sobre tempo de impacto.** Fix técnico não traz ranking em 24h. Re-crawl + re-index leva 1-30 dias. Reranking leva 30-90 dias.
+
+10. **Não substitui auditoria.** Skill 1 (`seo-local-auditor`) faz diagnóstico holístico; Skill 13 faz aprofundamento técnico. Complementam-se.
+
+## Fluxo de execução
+
+### Etapa 1 — Coleta inicial
+
+Antes de qualquer diagnóstico, levante:
+
+**Acesso e contexto:**
+- URL principal do site/sistema
+- Cliente tem acesso ao Google Search Console (GSC)?
+- Cliente tem acesso ao servidor / FTP / cPanel / hospedagem?
+- Stack técnico:
+ - CMS (WordPress, Wix, Shopify, custom)
+ - Framework (Elementor, Next.js, Vue, React, Angular, Astro, Hugo)
+ - Hospedagem (qual provedor)
+ - Servidor (nginx, apache, IIS, edge)
+ - CDN (Cloudflare? outro?)
+- Site novo ou existente?
+- Mudou algo recentemente (migração, redesign, plugin)?
+
+**Sintoma específico:**
+- O que o cliente está vendo?
+- Search Console mostra erros? Quais?
+- Comparativo: o que rankeava antes vs agora?
+- Páginas específicas com problema?
+
+Se faltar acesso ao GSC, **antes de mais nada** instrua o cliente a configurar. Sem GSC, diagnóstico é parcial.
+
+### Etapa 2 — Diagnóstico em 5 camadas
+
+Execute em ordem. Não pular.
+
+#### CAMADA 1 — ACESSIBILIDADE
+
+**Pergunta:** o Googlebot consegue chegar no servidor?
+
+**Checks:**
+
+1. **DNS funcional?**
+ - `dig dominio.com.br` ou `nslookup dominio.com.br`
+ - Resolve em IP válido?
+
+2. **Servidor responde?**
+ - `curl -I https://dominio.com.br`
+ - Status 200 OK?
+ - Tempo de resposta razoável (< 3s)?
+
+3. **HTTPS configurado corretamente?**
+ - Certificado válido?
+ - HSTS ativo?
+ - Redirect HTTP → HTTPS funciona?
+
+4. **robots.txt acessível e correto?**
+ - `https://dominio.com.br/robots.txt` retorna 200?
+ - Conteúdo NÃO bloqueia `User-agent: Googlebot`?
+ - Erro comum: `Disallow: /` (bloqueia tudo)
+ - Erro comum: `Disallow: /wp-admin/` ok, mas `Disallow: /wp-content/` quebra imagens
+
+5. **Server returns código correto?**
+ - Páginas que existem retornam 200
+ - Páginas removidas retornam 410 ou 404 (não 200 com mensagem "página não encontrada")
+ - Páginas movidas retornam 301
+ - **Cuidado com Soft 404** (página de erro com status 200)
+
+#### CAMADA 2 — CRAWLABILITY
+
+**Pergunta:** o Googlebot consegue navegar e descobrir todas as páginas?
+
+**Checks:**
+
+1. **sitemap.xml existe e está correto?**
+ - `https://dominio.com.br/sitemap.xml` retorna 200?
+ - XML válido (não erro de parse)?
+ - Lista todas as URLs importantes?
+ - Não lista URLs com noindex?
+ - Lista canonical URLs (não versões com parâmetro)?
+ - `lastmod` atualizado em mudanças recentes?
+ - Tamanho < 50.000 URLs por sitemap (limite Google)?
+ - Se site grande: tem sitemap-index?
+
+2. **Sitemap registrado no GSC?**
+ - Cliente confirma no Search Console → Sitemaps?
+ - Status: Sucesso, sem erros?
+
+3. **Internal linking funciona?**
+ - Cada página importante tem links pra ela de pelo menos 1 outra página?
+ - Páginas órfãs (sem links internos apontando) — Google pode nem descobrir
+ - Depth de cliques: nenhuma página importante a mais de 3-4 cliques da home
+
+4. **Redirects funcionam?**
+ - Cadeia de redirects: A → B → C → D quebra crawl budget
+ - Idealmente: A → D direto (1 redirect, não 3)
+ - 301 vs 302 vs 307 vs 308: usar `301` pra mudanças permanentes
+ - Verificar com `curl -I` ou `curl -IL`
+
+5. **Crawl budget otimizado?**
+ - URLs com parâmetros gerando infinitas variações?
+ - Pages de filtros gerando combinatorial explosion?
+ - URLs de busca interna sendo indexadas?
+
+6. **Paginação correta?**
+ - `rel="next"` e `rel="prev"` foram depreciados pelo Google em 2019
+ - Páginas paginadas (2, 3, 4) devem ter canonical próprio (não apontar pra página 1)
+ - Cada página com title diferenciado
+
+#### CAMADA 3 — RENDERABILITY (CRÍTICO PRA SITES JS)
+
+**Pergunta:** o Googlebot consegue VER o conteúdo da página?
+
+**Checks pra site WordPress + Elementor (server-rendered):**
+
+1. **View source mostra conteúdo?**
+ - `curl https://dominio.com.br/pagina | grep "[texto chave]"`
+ - Se conteúdo aparece no HTML cru → ok
+ - Se HTML cru mostra `<div id="root"></div>` vazio → problema!
+
+**Checks pra site React/Vue/Next/Angular (potencialmente client-rendered):**
+
+1. **Modo de renderização identificado:**
+ - **CSR (Client-Side Rendering):** HTML cru vazio, JS popula. **PROBLEMA SEO crítico em sites Vue/React puro sem SSR.**
+ - **SSR (Server-Side Rendering):** servidor renderiza, manda HTML completo. **OK pra SEO.**
+ - **SSG (Static Site Generation):** páginas pré-buildadas em HTML. **Melhor cenário SEO.**
+ - **ISR (Incremental Static Regeneration, Next.js):** SSG + revalidação. **OK pra SEO.**
+ - **Dynamic Rendering:** servidor detecta Googlebot, manda HTML pré-renderizado; usuário pega CSR. **Funcional mas desencorajado em 2026.**
+
+2. **Mobile-first rendering:**
+ - Google avalia mobile há anos
+ - Site renderiza ok no mobile?
+ - Conteúdo visível sem scroll horizontal?
+ - JavaScript executa em mobile dentro do limite de tempo do Googlebot?
+
+3. **Lazy loading de conteúdo crítico:**
+ - Texto importante NÃO deve ser lazy-loaded
+ - Imagens above-the-fold NÃO devem ter `loading="lazy"`
+ - Conteúdo dependente de scroll/interação não é indexável
+
+4. **Tools de validação:**
+ - **Google Search Console → Inspect URL** — mostra HTML renderizado pelo Googlebot
+ - **Mobile-Friendly Test** — confirma renderização mobile
+ - **Rich Results Test** — confirma schema e renderização
+ - **Manual:** `curl -A "Googlebot/2.1" https://dominio.com.br` vs `curl https://dominio.com.br` — comparar
+
+5. **Frameworks específicos:**
+
+ **Next.js:**
+ - Usa SSR/SSG por default (App Router). Verifica se páginas estão usando `'use server'` corretamente
+ - Páginas marcadas `'use client'` precisam ter SSR do shell
+ - Metadata API (Next 13+) gera meta tags server-side
+
+ **Vue.js (puro):**
+ - SPA sem SSR é problema SEO. Recomendar Nuxt.js
+ - Se Nuxt: confirmar modo SSR/SSG ativado em `nuxt.config.js`
+
+ **React (puro):**
+ - SPA sem framework SSR é problema. Recomendar Next.js, Remix ou Gatsby
+ - Create React App (CRA) puro = ruim pra SEO
+
+ **Angular:**
+ - SPA sem SSR é problema. Recomendar Angular Universal
+
+ **Svelte:**
+ - SPA puro = ruim. Recomendar SvelteKit (SSR/SSG)
+
+#### CAMADA 4 — INDEXABILITY
+
+**Pergunta:** o Google quer indexar essas páginas?
+
+**Checks:**
+
+1. **`noindex` em meta robots ou x-robots-tag:**
+ - `<meta name="robots" content="noindex, follow">` impede indexação
+ - `x-robots-tag: noindex` no header HTTP idem
+ - Cuidado: WordPress tem opção "Discourage search engines" que adiciona noindex em TUDO. Erro frequente em sites migrados de staging.
+
+2. **Canonical correto:**
+ - `<link rel="canonical" href="...">` em toda página
+ - Aponta pra si mesma (versão preferida) OU pra página master
+ - Erro grave: canonical apontando pra página diferente da que se quer indexar
+ - Erro: canonical apontando pra HTTP quando site é HTTPS
+ - Erro: canonical relativo (`/pagina`) em vez de absoluto (`https://...`)
+ - Páginas paginadas: canonical pra si mesma, não pra página 1
+
+3. **Duplicate content:**
+ - Versões com/sem www, http/https, trailing slash, parâmetros
+ - Cada variação deveria redirecionar pra canonical
+ - Conteúdo igual em URLs diferentes = canonical apontando pra master
+
+4. **Hreflang (sites multi-idioma):**
+ - Tag presente em todas as variações de idioma
+ - Auto-referência (cada versão lista a si própria)
+ - Reciprocidade (versão PT aponta pra EN e vice-versa)
+ - Códigos corretos: `pt-BR`, `en-US`, `es-ES`
+ - x-default pra versão padrão
+
+5. **Qualidade percebida pelo Google:**
+ - Conteúdo thin (< 300 palavras em página de serviço)
+ - Conteúdo duplicado de outro site
+ - Páginas geradas automaticamente sem valor
+ - Páginas com 1 linha de conteúdo + 1000 anúncios
+
+#### CAMADA 5 — RANKABILITY
+
+**Pergunta:** se indexado, vai rankear?
+
+Essa camada cruza com Skills 7, 8, 10:
+
+- Conteúdo cobre intenção da busca?
+- Site tem autoridade temática?
+- Concorrentes dominam? Como?
+- Sinais de E-E-A-T presentes?
+
+Skill 13 não aprofunda camada 5 — delega pra skills de conteúdo/estratégia.
+
+### Etapa 3 — Diagnóstico do Google Search Console
+
+Cliente tem GSC? Skill interpreta os relatórios principais:
+
+#### Página "Indexação de páginas" (Coverage)
+
+**Páginas indexadas:**
+- Quantidade
+- Cresceu ou caiu nos últimos 30 dias?
+
+**Páginas NÃO indexadas — interpretar cada motivo:**
+
+| Motivo no GSC | Significado | Ação |
+|---|---|---|
+| **Crawled - currently not indexed** | Google viu mas não quis indexar | Melhorar qualidade do conteúdo, internal linking, autoridade do site |
+| **Discovered - currently not indexed** | Google descobriu URL mas ainda não rastreou | Aguardar (crawl budget) ou submeter manualmente via Inspect URL |
+| **Excluded by 'noindex' tag** | Página tem noindex (intencional ou bug) | Verificar se noindex é intencional; se não, remover |
+| **Soft 404** | Página retorna 200 mas Google detectou que é página de erro | Corrigir conteúdo ou retornar 404 real |
+| **Not found (404)** | Página retorna 404 | Restaurar página se importante, ou criar 301 pra alternativa |
+| **Page with redirect** | URL redireciona pra outra | Ok se intencional; URL final precisa estar indexada |
+| **Blocked by robots.txt** | robots.txt bloqueia | Verificar se bloqueio é intencional |
+| **Alternate page with proper canonical tag** | URL tem canonical apontando pra outra | Comportamento correto |
+| **Duplicate without user-selected canonical** | Google escolheu canonical sozinho | Definir canonical explícito |
+| **Duplicate, Google chose different canonical than user** | Google ignorou seu canonical | Investigar por que Google preferiu outra |
+| **URL is not on Google** (status genérico) | URL não está indexada | Investigar motivo específico |
+
+#### Página "Experiência" (Core Web Vitals)
+
+Delega pra Skill 6 (`core-web-vitals-fixer`).
+
+#### Página "Aprimoramentos" (Enhancements)
+
+- Erros de schema (delega pra Skill 2 — `schema-jsonld-builder`)
+- Mobile usability (verificar viewport, tap targets, font size)
+- Sitemap (verificar status: success / errors / warnings)
+
+#### Página "Performance" (Search Analytics)
+
+- Queries onde o site aparece
+- Pages que recebem cliques
+- Países/dispositivos
+- Comparativo com período anterior
+
+### Etapa 4 — Casos específicos comuns
+
+#### Caso 1: Site não está sendo indexado
+
+**Diagnóstico em ordem:**
+
+1. `site:dominio.com.br` no Google → quantos resultados?
+ - 0 resultados → site totalmente fora do índice
+ - Poucos resultados → indexação parcial
+ - Muitos resultados → indexação ok, problema é ranking
+
+2. `https://dominio.com.br/robots.txt` → bloqueio?
+
+3. `curl -I https://dominio.com.br` → status 200? HTTPS ok?
+
+4. View source da home → `<meta name="robots" content="noindex">`?
+
+5. Search Console → Inspect URL → status?
+
+6. Sitemap submetido? Status no GSC?
+
+**Soluções comuns:**
+
+```
+# Caso "Discourage search engines" ativado no WordPress
+Settings → Reading → desmarcar "Discourage search engines from indexing this site"
++ remover meta noindex se estiver hardcoded no tema
+
+# Caso robots.txt bloqueia tudo
+User-agent: *
+Allow: /
+
+Sitemap: https://dominio.com.br/sitemap.xml
+
+# Caso noindex em todas as páginas (header HTTP)
+# Verificar no .htaccess ou nginx.conf se há:
+# Header set X-Robots-Tag "noindex"
+# REMOVER
+```
+
+#### Caso 2: Site React/Vue não rankeia
+
+**Diagnóstico:**
+
+1. `curl https://dominio.com.br` → HTML mostra conteúdo ou vazio?
+ - Vazio = problema crítico
+ - Tem conteúdo = ok
+
+2. Search Console → Inspect URL → "View tested page" → "HTML" → Googlebot vê conteúdo?
+
+3. Identificar framework e modo de renderização
+
+**Soluções por framework:**
+
+```javascript
+// Next.js — garantir SSR/SSG em páginas críticas
+// app/page.tsx (App Router) - SSR por default
+export default async function Home() {
+  const data = await fetch('...', { cache: 'force-cache' });
+  return <div>{/* conteúdo */}</div>;
+}
+
+// Pra SSG em rotas dinâmicas
+export async function generateStaticParams() {
+  return [{ slug: 'pagina-1' }, { slug: 'pagina-2' }];
+}
+
+// pages/[slug].tsx (Pages Router) - SSR
+export async function getServerSideProps(context) {
+  // busca dados
+  return { props: { data } };
+}
+
+// Ou SSG
+export async function getStaticProps() {
+  // busca dados em build time
+  return { props: { data } };
+}
+```
+
+```javascript
+// Vue/Nuxt — confirmar modo no nuxt.config.js
+export default {
+  ssr: true, // SSR ativado
+  target: 'static', // ou 'server'
+  // ...
+}
+```
+
+```javascript
+// React puro sem framework SSR
+// Recomendação: migrar pra Next.js ou Remix
+// Solução alternativa: dynamic rendering via prerender.io ou rendertron
+```
+
+#### Caso 3: Migração de domínio
+
+**Checklist obrigatório:**
+
+```markdown
+## Pré-migração (1-2 semanas antes)
+- [ ] Backup completo do site antigo
+- [ ] Lista exaustiva de todas as URLs do site antigo (Screaming Frog ou Sitebulb)
+- [ ] Mapa de URL antiga → URL nova (redirect map)
+- [ ] Validação do redirect map (todas as URLs antigas têm destino na nova)
+- [ ] Site novo pronto, em staging, indexado como noindex
+- [ ] Search Console configurado pro domínio novo
+- [ ] Google Analytics configurado pro domínio novo
+- [ ] Avisar GSC: Settings → Change of Address (preparar)
+
+## Dia da migração
+- [ ] Implementar 301 redirects (.htaccess, nginx.conf, ou middleware)
+- [ ] Atualizar sitemap.xml no domínio novo
+- [ ] Submeter sitemap no GSC do domínio novo
+- [ ] Remover noindex do domínio novo
+- [ ] Verificar redirects funcionando: curl -IL https://antigo.com.br
+- [ ] Confirmar SSL no domínio novo
+- [ ] Notificar parceiros (atualizar backlinks importantes)
+
+## Pós-migração (primeiras 4 semanas)
+- [ ] Monitorar GSC do domínio antigo (espera erros 404)
+- [ ] Monitorar GSC do domínio novo (espera crescimento de indexação)
+- [ ] Settings → Change of Address no GSC antigo, apontando pro novo
+- [ ] Acompanhar ranking de keywords principais (queda esperada 10-30%)
+- [ ] Verificar Analytics de tráfego (queda esperada 10-30%)
+- [ ] Atualizar GBP com novo site (Skill 3)
+- [ ] Atualizar citations principais com novo URL (Skill 11)
+- [ ] Manter redirects 301 por no mínimo 6-12 meses
+
+## Recuperação esperada
+- Semana 1-2: queda de 20-40% de tráfego
+- Semana 3-6: recuperação parcial
+- Semana 7-12: ranking estabiliza
+- Mês 4-6: alcança ou supera ranking pré-migração
+
+## Bandeira vermelha (algo deu errado)
+- Queda > 50% após semana 4
+- Sumiu do índice
+- Manual action no GSC
+```
+
+#### Caso 4: Mudança HTTP → HTTPS
+
+```apache
+# .htaccess (Apache)
+RewriteEngine On
+RewriteCond %{HTTPS} off
+RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
+```
+
+```nginx
+# nginx
+server {
+    listen 80;
+    server_name dominio.com.br www.dominio.com.br;
+    return 301 https://$server_name$request_uri;
+}
+```
+
+Depois:
+- Atualizar `sitemap.xml` com URLs HTTPS
+- Verificar canonical aponta pra HTTPS
+- HSTS header pra forçar HTTPS no navegador
+- Submeter `https://dominio.com.br` como nova propriedade no GSC
+
+#### Caso 5: www vs non-www
+
+Escolher UMA versão como canônica. Redirecionar a outra com 301.
+
+```apache
+# Forçar www
+RewriteEngine On
+RewriteCond %{HTTP_HOST} ^dominio\.com\.br$
+RewriteRule ^(.*)$ https://www.dominio.com.br/$1 [L,R=301]
+```
+
+```apache
+# Forçar non-www (mais comum hoje)
+RewriteEngine On
+RewriteCond %{HTTP_HOST} ^www\.dominio\.com\.br$
+RewriteRule ^(.*)$ https://dominio.com.br/$1 [L,R=301]
+```
+
+#### Caso 6: E-commerce — facetas e filtros
+
+E-commerces geram explosão de URLs com filtros (`/categoria?cor=azul&tamanho=m&preco=100`). Solução padrão:
+
+```html
+<!-- URLs com facetas: canonical pra categoria mãe -->
+<link rel="canonical" href="https://dominio.com.br/categoria">
+
+<!-- OU noindex em variações de filtro -->
+<meta name="robots" content="noindex, follow">
+```
+
+**Páginas que devem indexar (canonical pra si):**
+- Categorias principais
+- Subcategorias importantes
+- Combinações de filtro com volume de busca real (ex: "tênis nike masculino" pode merecer página própria)
+
+**Páginas que NÃO devem indexar:**
+- Filtros combinatórios sem busca
+- URLs com parâmetro de ordenação (`?sort=price`)
+- Carrinho, login, checkout
+- Páginas de busca interna
+
+#### Caso 7: Páginas órfãs
+
+Página existe mas nenhuma outra linka pra ela = Google pode nem descobrir.
+
+**Diagnóstico:** Screaming Frog → "Orphaned URLs" report.
+
+**Solução:** adicionar página ao menu, breadcrumb, footer, ou linkar contextualmente de outras páginas.
+
+#### Caso 8: Pagination
+
+Páginas tipo `/blog?page=2`, `/blog?page=3`:
+
+- **Não use** `rel="next"` e `rel="prev"` (depreciados pelo Google em 2019)
+- Cada página tem canonical pra si mesma (não pra página 1)
+- Cada página tem title único: "Blog - Página 2 | Marca"
+- Considerar paginação por URL semântica: `/blog/page/2`
+
+#### Caso 9: Internacionalização
+
+Site PT + EN + ES. Estrutura recomendada (em ordem de preferência):
+
+1. **Subdiretórios:** `dominio.com.br/pt`, `dominio.com.br/en` — mais simples, autoridade concentrada
+2. **Subdomínios:** `pt.dominio.com`, `en.dominio.com` — mais separação, autoridade dividida
+3. **ccTLDs:** `dominio.com.br`, `dominio.com.us` — máxima separação, autoridade totalmente separada
+
+Hreflang em todas as versões:
+
+```html
+<link rel="alternate" hreflang="pt-BR" href="https://dominio.com.br/pt/">
+<link rel="alternate" hreflang="en-US" href="https://dominio.com.br/en/">
+<link rel="alternate" hreflang="es-ES" href="https://dominio.com.br/es/">
+<link rel="alternate" hreflang="x-default" href="https://dominio.com.br/">
+```
+
+#### Caso 10: Crawl budget de site grande
+
+Sites com 50k+ páginas têm limite de crawl. Sintomas:
+- Páginas demoram pra aparecer no índice
+- Mudanças demoram pra refletir
+- Páginas antigas continuam indexadas mesmo após exclusão
+
+**Soluções:**
+- Bloquear via robots.txt URLs sem valor (filtros, parâmetros)
+- Otimizar internal linking (priorizar páginas importantes)
+- Submeter sitemap segmentado por prioridade
+- 410 (não 404) em páginas removidas (sinaliza pro Google parar de tentar)
+- Páginas com baixo valor: noindex + follow
+
+## Catálogo de templates prontos
+
+### robots.txt — padrão WordPress
+
+```
+User-agent: *
+Allow: /
+
+# Bloquear áreas administrativas
+Disallow: /wp-admin/
+Disallow: /wp-includes/
+Disallow: /wp-login.php
+Disallow: /xmlrpc.php
+Disallow: /readme.html
+Disallow: /license.txt
+
+# Permitir admin-ajax (necessário pra plugins)
+Allow: /wp-admin/admin-ajax.php
+
+# Bloquear arquivos sensíveis
+Disallow: /wp-content/uploads/wpforms/
+Disallow: /?s=
+Disallow: /search/
+Disallow: /*?replytocom
+
+# Permitir CSS, JS, imagens (CRÍTICO pro Googlebot renderizar)
+Allow: /wp-content/uploads/
+Allow: /wp-content/plugins/*.css
+Allow: /wp-content/plugins/*.js
+Allow: /wp-content/themes/*.css
+Allow: /wp-content/themes/*.js
+
+# Sitemap
+Sitemap: https://dominio.com.br/sitemap.xml
+Sitemap: https://dominio.com.br/sitemap-news.xml
+```
+
+### robots.txt — padrão Next.js / SPA
+
+```
+User-agent: *
+Allow: /
+
+# Bloquear APIs e área administrativa
+Disallow: /api/
+Disallow: /admin/
+Disallow: /_next/static/
+
+# Permitir assets críticos
+Allow: /_next/static/css/
+Allow: /_next/static/chunks/
+
+# Sitemap
+Sitemap: https://dominio.com.br/sitemap.xml
+```
+
+### sitemap.xml — estrutura básica
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://dominio.com.br/</loc>
+    <lastmod>2026-05-12</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://dominio.com.br/sobre</loc>
+    <lastmod>2026-04-15</lastmod>
+    <changefreq>monthly</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <!-- mais URLs -->
+</urlset>
+```
+
+### sitemap-index.xml (sites grandes, > 50k URLs)
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <sitemap>
+    <loc>https://dominio.com.br/sitemap-pages.xml</loc>
+    <lastmod>2026-05-12</lastmod>
+  </sitemap>
+  <sitemap>
+    <loc>https://dominio.com.br/sitemap-products.xml</loc>
+    <lastmod>2026-05-12</lastmod>
+  </sitemap>
+  <sitemap>
+    <loc>https://dominio.com.br/sitemap-posts.xml</loc>
+    <lastmod>2026-05-12</lastmod>
+  </sitemap>
+</sitemapindex>
+```
+
+### .htaccess — boas práticas SEO
+
+```apache
+# Forçar HTTPS
+RewriteEngine On
+RewriteCond %{HTTPS} off
+RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
+
+# Forçar non-www
+RewriteCond %{HTTP_HOST} ^www\.dominio\.com\.br$
+RewriteRule ^(.*)$ https://dominio.com.br/$1 [L,R=301]
+
+# Remover trailing slash (ou manter, escolher um padrão)
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^(.+)/$ /$1 [R=301,L]
+
+# Cache headers pra SEO + performance
+<FilesMatch "\.(jpg|jpeg|png|gif|webp|svg|css|js|woff2|woff|ttf)$">
+    Header set Cache-Control "max-age=31536000, public"
+</FilesMatch>
+
+# Compressão Gzip
+<IfModule mod_deflate.c>
+    AddOutputFilterByType DEFLATE text/html text/css text/javascript application/javascript application/x-javascript
+</IfModule>
+```
+
+### nginx.conf — boas práticas SEO
+
+```nginx
+server {
+    listen 443 ssl http2;
+    server_name dominio.com.br;
+    
+    # SSL config
+    ssl_certificate /path/to/cert;
+    ssl_certificate_key /path/to/key;
+    
+    # HSTS
+    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
+    
+    # Compressão
+    gzip on;
+    gzip_vary on;
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
+    
+    # Cache assets
+    location ~* \.(jpg|jpeg|png|gif|webp|svg|css|js|woff2)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}
+
+# Redirect HTTP -> HTTPS
+server {
+    listen 80;
+    server_name dominio.com.br www.dominio.com.br;
+    return 301 https://dominio.com.br$request_uri;
+}
+
+# Redirect www -> non-www
+server {
+    listen 443 ssl http2;
+    server_name www.dominio.com.br;
+    return 301 https://dominio.com.br$request_uri;
+}
+```
+
+## Estrutura obrigatória do entregável
+
+```markdown
+# 🔧 AUDITORIA SEO TÉCNICA — [SITE / SISTEMA]
+
+## 📊 CONTEXTO
+- URL: [...]
+- Stack: [...]
+- Acesso GSC: [sim/não]
+- Acesso servidor: [sim/não]
+- Sintoma principal: [...]
+
+## 🎯 DIAGNÓSTICO EM 5 CAMADAS
+
+### CAMADA 1 — ACESSIBILIDADE
+- [check 1]: ✅ / ⚠️ / ❌
+- [check 2]: [...]
+[...]
+
+### CAMADA 2 — CRAWLABILITY
+[...]
+
+### CAMADA 3 — RENDERABILITY
+- Modo de renderização identificado: [CSR / SSR / SSG / ISR / Dynamic]
+- Problemas: [...]
+
+### CAMADA 4 — INDEXABILITY
+[...]
+
+### CAMADA 5 — RANKABILITY
+[Delegação pra outras skills]
+
+## 🔍 DIAGNÓSTICO DO SEARCH CONSOLE
+
+[Interpretação de cada relatório relevante]
+
+## 🚨 PROBLEMAS IDENTIFICADOS
+
+### Problema #1: [Título]
+**Camada:** [N]
+**Severidade:** Crítica / Alta / Média / Baixa
+**Diagnóstico:** [...]
+**Causa raiz:** [...]
+**Solução:**
+
+```código pronto pra colar```
+
+**Trade-off / risco:** [...]
+**Tempo de impacto esperado:** [...]
+
+[Repetir pra cada problema]
+
+## 🛠️ PLANO DE CORREÇÃO PRIORIZADO
+
+### FASE 1 — Críticos (resolver hoje)
+1. [...]
+
+### FASE 2 — Importantes (1-2 semanas)
+2. [...]
+
+### FASE 3 — Melhorias (1-3 meses)
+3. [...]
+
+## 📝 CÓDIGO PRONTO PRA COLAR
+
+### robots.txt
+[código]
+
+### sitemap.xml (ou estrutura)
+[código]
+
+### .htaccess / nginx.conf
+[código]
+
+### Outros (next.config.js, etc.)
+[código]
+
+## ✅ CHECKLIST PÓS-IMPLEMENTAÇÃO
+- [ ] Backup completo antes de qualquer mudança
+- [ ] Testar em staging (se possível)
+- [ ] Aplicar mudanças
+- [ ] Validar via curl / GSC Inspect URL
+- [ ] Submeter sitemap no GSC
+- [ ] Solicitar reindexação manual de páginas críticas
+- [ ] Monitorar GSC por 14-30 dias
+
+## ⏰ TEMPO DE IMPACTO ESPERADO
+
+- Mudanças em robots.txt / noindex: 1-7 dias
+- Redirects: 1-30 dias pra Google reprocessar
+- Sitemap atualizado: 7-30 dias
+- Mudança de framework / arquitetura: 30-90 dias
+- Migração de domínio: 60-180 dias
+
+## 🔗 DELEGAÇÕES PRA OUTRAS SKILLS
+
+- Performance específica → Skill 6 (`core-web-vitals-fixer`)
+- Schema → Skill 2 (`schema-jsonld-builder`)
+- Meta tags → Skill 5 (`meta-tags-optimizer`)
+- Conteúdo / autoridade → Skills 7, 8
+
+## ⚠️ ALERTAS
+
+[Riscos específicos, mudanças que requerem cuidado especial]
+```
+
+## Erros comuns que esta skill EVITA
+
+1. **Diagnosticar sem inspecionar.** Sempre executar curl, view source, GSC Inspect URL antes de prescrever.
+
+2. **Pular camada de diagnóstico.** Acessibilidade → Crawlability → Renderability → Indexability → Rankability. Sempre em ordem.
+
+3. **Ignorar Search Console.** Sem GSC, diagnóstico é parcial. Skill instrui configurar antes de aprofundar.
+
+4. **Recomendar Dynamic Rendering pra novo projeto.** Google desencoraja desde 2022. Recomendar SSR/SSG.
+
+5. **Assumir que site WordPress não tem problema técnico.** WP + Elementor pode ter noindex acidental, robots.txt mal configurado, plugin gerando duplicate content.
+
+6. **Recomendar `rel="next/prev"` em paginação.** Depreciado em 2019. Usar canonical pra si mesma + title diferenciado.
+
+7. **Esquecer mobile-first.** Google indexa versão mobile. Site bem no desktop e mal no mobile = problema crítico.
+
+8. **Mudar redirects sem mapa.** Migração sem URL mapping destrói ranking. Sempre redirect map exaustivo antes.
+
+9. **Confundir 301 com 302.** 301 = permanente, passa autoridade. 302 = temporário, não passa autoridade plenamente. Pra mudanças permanentes, sempre 301.
+
+10. **Não distinguir Soft 404 de 404 real.** Página de erro com status 200 confunde Google. Retornar 404 real.
+
+11. **Ignorar cadeia de redirects.** A → B → C → D = perda de crawl budget e autoridade. Encurtar pra A → D.
+
+12. **Recomendar fix técnico sem mencionar tempo de impacto.** Cliente espera resultado em 24h, vê em 30 dias = expectativa quebrada. Skill sempre menciona prazo realista.
+
+13. **Apagar páginas removidas com 404.** Pra páginas removidas permanentemente, usar 410 (Gone) — Google retira do índice mais rápido.
+
+14. **Recomendar disavow leviamente.** Disavow é arma pesada. Só usar após auditoria de backlinks tóxicos e análise de manual action.
+
+15. **Esquecer de validar mudança.** Aplicou fix? Confirmar via curl / GSC / re-crawl. Sem validação, fica no escuro.
+
+## Edge cases
+
+**Site Shopify com problemas técnicos:**
+Shopify tem limitações (não dá pra editar robots.txt antes de Shopify 2.0, themes têm schema próprio). Diagnóstico se adapta. Sometimes recomendar mudar de tema.
+
+**Site Wix com problemas:**
+Wix gerencia muita coisa automaticamente. Cliente tem controle limitado. Algumas correções exigem upgrade de plano ou migração de plataforma.
+
+**Sistema SaaS (LAXNEST, CRONOS, ZARK CRM tipo):**
+SaaS tem páginas atrás de auth (não indexáveis) + páginas públicas (landing, blog). Skill foca em otimizar páginas públicas + garantir que privadas não vazam.
+
+**Sites multi-marca compartilhando código (white label):**
+Cuidado com duplicate content entre marcas. Cada marca precisa de conteúdo único o suficiente. Canonical não resolve sozinho.
+
+**E-commerce com 100k+ produtos:**
+Crawl budget é gargalo. Estratégia: noindex em variações de baixo valor, sitemap segmentado, internal linking otimizado.
+
+**Cliente sem dev:**
+Mudanças em servidor exigem dev ou suporte da hospedagem. Skill instrui o que pedir ao suporte (ex: "ative HTTP/2 no plano X"). Algumas coisas só funcionam com mudança de plano.
+
+**Penalidade manual no Search Console:**
+Caso grave. Skill entrega plano de recuperação: identificar causa, corrigir, request reconsideration. Pode levar 30-90 dias.
+
+**Sistema custom com SEO ruim por design:**
+Refactor estrutural. Skill aponta mudanças em código (rota, render mode, meta tags) + estima esforço de dev.
+
+## Conexão com outras skills ZARK
+
+- **`seo-local-auditor`** (1): diagnóstico holístico → quando achado técnico → aciona Skill 13
+- **`schema-jsonld-builder`** (2): schema é parte da indexability — Skill 13 detecta gap, Skill 2 implementa
+- **`gbp-optimizer`** (3): após migração de domínio, atualizar GBP — delegação
+- **`service-area-page-builder`** (4): páginas criadas precisam estar indexáveis — Skill 13 valida
+- **`meta-tags-optimizer`** (5): meta tags são parte de indexability — Skill 13 detecta noindex acidental
+- **`core-web-vitals-fixer`** (6): performance é métrica técnica — Skill 6 cuida, Skill 13 cuida do resto
+- **`seo-content-writer-br`** (8): conteúdo precisa estar em página indexável — fundação da Skill 13
+- **`seo-orchestrator`**: pode acionar Skill 13 quando diagnóstico indica problema técnico profundo
+
+## Exemplo de invocação esperada
+
+**Usuário:** "Meu site React não tá rankeando, nenhuma página aparece no Google"
+
+**Resposta esperada:** acionar essa skill, pedir URL, executar `curl` pra ver HTML cru vs renderizado, identificar CSR sem SSR, recomendar Next.js migration ou prerendering, fornecer código de exemplo.
+
+**Usuário:** "Quero migrar dominioantigo.com.br pra dominionovo.com.br sem perder ranking"
+
+**Resposta esperada:** acionar essa skill, fornecer checklist completo de migração (pré, dia, pós), incluindo mapa de URLs, 301 redirects, GSC Change of Address, monitoramento.
+
+**Usuário:** "Search Console mostra 'Crawled - currently not indexed' em 500 páginas"
+
+**Resposta esperada:** acionar essa skill, explicar o que significa, perguntar exemplos de URLs afetadas, diagnosticar (qualidade? thin content? duplicate?), prescrever ação por categoria.
+
+**Usuário:** "Site WordPress não tá indexando, já fiz tudo certo"
+
+**Resposta esperada:** acionar essa skill, fazer diagnóstico em 5 camadas, verificar "Discourage search engines" do WP, robots.txt, noindex meta, sitemap, canonical, status 200, etc. Frequentemente é uma das checkboxes do WordPress.
+
+**Usuário:** "Tenho 50.000 URLs no e-commerce, só 5.000 indexadas"
+
+**Resposta esperada:** acionar essa skill, identificar problema de crawl budget, prescrever estratégia (noindex em filtros, sitemap segmentado, internal linking, 410 em produtos descontinuados).