Fluxo de Trabalho do Orquestrador de Crescimento SEO-AEO

Arquivo: .agent/workflows/seo-aeo-orchestrator/WORKFLOW.md ID do Fluxo de Trabalho: seo-aeo-orchestrator Versão: 2.0.0 Modo de Execução: portões sequenciais com trabalho de conteúdo paralelo onde seguro

Propósito

Transformar um site ou base de código em um sistema de crescimento SEO/AEO baseado em evidências. O fluxo de trabalho começa com uma auditoria, implementa correções aprovadas, confirma a estratégia de negócios e de palavras-chave, pesquisa a intenção de busca atual, cria conteúdo fundamental, prepara a distribuição externa, configura a medição, implanta, verifica e oferece monitoramento semanal.

O fluxo de trabalho é projetado para agentes de codificação que trabalham diretamente em um repositório. Ele deve entender o framework do projeto, rotas, armazenamento de conteúdo, implementação de metadados, geração de sitemap/robots, caminho de implantação e limites de autenticação antes de editar ou publicar.

Ponto de entrada do fluxo de trabalho

{
  "workflow_input": {
    "project_path": "string — current project or repository",
    "site_url": "string — optional live URL",
    "business_type": "string — optional description of the business",
    "target_audience": "string — optional audience",
    "conversion_goal": "string — signup, demo, purchase, download, contact, or other",
    "user_keywords": ["string — optional owner-approved targets"],
    "location": "string — optional market or country",
    "foundation_page_count": "integer — 5–10, default 10",
    "research_mode": "browser | api | both | unavailable — default both",
    "existing_content": ["string — optional URLs, routes, or titles"],
    "tone": "professional | conversational | bold | empathetic | authoritative",
    "monitoring_preference": "ask | one-time | recurring | none — default ask"
  }
}

Portões de autorização

O agente pode inspecionar a base de código, executar verificações locais e rascunhar recomendações sem confirmação adicional. Antes de cada mutação externa ou material, obtenha a autorização necessária:

• implementar alterações de código/conteúdo: siga a solicitação do usuário e preserve o trabalho não relacionado;
• implantar ou enviar para o Git: confirme quando o usuário ainda não o solicitou;
• acessar o Google Search Console ou Bing Webmaster: peça ao usuário para autenticar no navegador ou fornecer um conector aprovado;
• enviar URLs ou sitemaps: confirme a propriedade exata e os URLs antes do envio;
• criar monitoramento recorrente: pergunte se o usuário deseja isso, mesmo que monitoring_preference seja ask.

Nunca afirme que uma conta está conectada, um sitemap foi enviado, um URL está indexado ou uma implantação está ativa sem evidências observáveis.

Arquitetura de execução

PHASE 0 — DISCOVERY
  inspect codebase, framework, routes, live URL, deployment, and content model
        │
        ▼
PHASE 1 — AUDIT
  SEO/AEO/technical/conversion audit with evidence and prioritized fixes
        │
        ▼
PHASE 2 — IMPLEMENTATION
  apply approved audit fixes, then re-audit and verify build/routes
        │
        ▼
PHASE 3 — STRATEGY CONFIRMATION
  ask for business context, target keywords, audience, location, and conversion goal
        │
        ▼
PHASE 4 — SEARCH-INTENT RESEARCH
  browser + API research when available; semantic fallback when unavailable
        │
        ▼
PHASE 5 — CONTENT FOUNDATION
  landing/product improvements + 5–10 foundational pages, default 10 when justified
        │
        ├───────────────┐
        ▼               ▼
  internal content   external distribution plan
        │               │
        └───────┬───────┘
                ▼
PHASE 6 — MEASUREMENT AND PUBLISHING
  Search Console/Bing setup (gated), sitemap/URL submission, deploy, verify
                │
                ▼
PHASE 7 — MONITORING
  weekly analysis, refresh recommendations, optional recurring automation

Fase 0 — Descobrir o projeto

1. Inspecione o repositório sem sobrescrever o trabalho do usuário.
2. Identifique o framework, gerenciador de pacotes, rotas, componentes de página, arquivos de conteúdo/CMS, auxiliares de metadados, geração de sitemap e robots, implementação de schema, padrões de link interno, configuração de ambiente e comandos de implantação.
3. Identifique se um blog já existe. Se não, determine a maneira nativa do projeto de adicionar páginas e preserve suas convenções.
4. Inspecione o URL ativo quando fornecido e registre o que foi realmente verificado.
5. Produza um mapa curto do projeto antes de fazer recomendações de conteúdo.

…