Planejador de Site MarketingOS
Transforma o que o cérebro do negócio já sabe, mais uma entrevista curta e pesquisa real, em um plano de site que alguém pode construir: um briefing, um mapa de intenção e uma especificação por página. O plano é o entregável. Esta habilidade para no plano aprovado: nunca constrói páginas, escreve cópia final, configura redirecionamentos ou escolhe design visual.
Contexto e pré-requisitos do MarketingOS
Sequência recomendada: mos-design-authentication → Configuração do projeto EmDash → mos-design-site-planner → mos-atomic-design-system. Nenhum deles é um pré-requisito obrigatório; se uma etapa anterior não foi executada, diga isso uma vez e continue.
Resolva o cérebro ativo do negócio e o projeto do site a partir da sessão atual e seus registros. Leia o BRAIN.md do cérebro ou as instruções do agente, CONTEXT.md e business/ (marca, voz, público, ofertas, estratégia, provas, concorrentes) antes de perguntar qualquer coisa. Se o CLI mos estiver disponível, mos context show --json nomeia os arquivos por trás de cada campo de contexto. Mantenha o contexto de cada negócio separado. Sem o MarketingOS, trabalhe a partir dos arquivos que o usuário fornecer e trate todo o resto como uma lacuna.
Use Bun para os scripts empacotados; se estiver faltando, aponte o usuário para https://bun.com/docs/installation. Resolva $SKILL para o diretório real que contém este SKILL.md; os locais de instalação diferem entre agentes.
Invocação: /mos-design-site-planner no Claude Code, $mos-design-site-planner no Codex. Faça perguntas com AskUserQuestion no Claude Code e como perguntas numeradas com opções com letras no Codex. Um prompt inicial impulsiona todo o fluxo de trabalho; mantenha cada aprovação na mesma conversa.
Rótulos de evidência
Cada descoberta de pesquisa e cada afirmação de intenção carrega um rótulo:
- medida: um número de uma ferramenta ou exportação (cliques do Search Console, um volume de palavra-chave, uma contagem de rastreamento), com o valor e um ID de fonte datado.
- observada: vista diretamente em uma data, mas não contada (sugestões de autocomplete, uma página de resultados, People Also Ask, um sitemap de concorrente, uma resposta de IA), com um ID de fonte datado.
- presumida: raciocínio ou a palavra do usuário, com o motivo anotado.
Uma descoberta sem fonte é presumida ou é omitida. Acesso a ferramentas, volumes de palavra-chave, perguntas do People Also Ask e fatos de negócios são relatados apenas quando uma execução realmente os produziu.
Fluxo de trabalho
Salve o progresso em <projeto>/site-plan/state.json após cada etapa para que uma sessão posterior possa retomar de onde esta parou. Formatos de arquivo, templates e o esquema de estado: references/output-format.md.
1. Pré-voo
Resolva o cérebro, o projeto do site (seu docs/project.md ou notas de projeto equivalentes) e qualquer URL de site existente. Se site-plan/state.json existir, relate sua etapa e retome a partir dela. Detecte quais ferramentas de pesquisa realmente funcionam nesta sessão: uma exportação ou ferramenta conectada do Search Console, chaves do DataForSEO, um rastreador (Scrapling ou fetch simples), pesquisa na web. Teste cada uma; uma chave no ambiente que falhar em seu teste de chamada não está disponível. Etapas de detecção: references/research.md. Se ainda não houver um projeto de site, pergunte uma vez onde salvar; o outputs/YYYY/MM-Mon/YYYY-MM-DD-site-plan/ do cérebro é o fallback.
Concluído quando o cérebro, projeto, local de salvamento, URL existente (ou "novo site") e a lista de ferramentas funcionais estão registrados em state.json.
2. O que já sei
Construa o cartão a partir do cérebro: negócio, serviços, locais e área de serviço, público, oferta, voz, provas e ação primária. Cada item nomeia seu arquivo de origem e é marcado como confirmado (declarado claramente no cérebro), inferido (lido nas entrelinhas) ou ausente. Mostre-o e deixe o usuário corrigi-lo. Formato do cartão: references/interview.md.
Concluído quando o usuário confirmou ou corrigiu o cartão.
3. Entrevista apenas com lacunas
Pergunte apenas sobre o que o cartão marca como inferido ou ausente, em lotes, cada pergunta com uma resposta recomendada e o motivo para ela. O banco de perguntas cobre metas, serviços de dinheiro, locais atendidos, novo site versus substituição, funcionalidade, ativos de prova, concorrentes e restrições: references/interview.md. Referências de design pertencem a mos-atomic-design-system e às habilidades de design; deixe-as de fora aqui.
Concluído quando cada campo do briefing é respondido ou registrado como uma LACUNA.
4. Trave o briefing
Apresente o briefing em uma tela: os fatos com suas fontes, as lacunas, o plano de pesquisa e quaisquer chamadas pagas com seu custo estimado. Peça um sim antes de gastar tempo ou dinheiro em pesquisa.
Concluído quando o usuário aprova o briefing; registre-o em decisions.md.
5. Pesquisa
Execute cada método que o pré-voo encontrou como funcional: rastreamento do site existente e inventário de URL, consultas e páginas de destino do Search Console, volumes de palavra-chave (DataForSEO quando chaveado, caso contrário, autocomplete rotulado como sem volume), páginas de resultados e People Also Ask, sitemaps de concorrentes e uma verificação opcional de respostas de IA. Fontes opcionais ausentes vão para a lista de lacunas de pesquisa e o trabalho continua. Métodos, fallbacks e relatório de custos: references/research.md. Cada fonte recebe uma linha datada em research/sources.md.
Concluído quando cada método produziu descobertas rotuladas ou uma entrada de lacuna.
6. Decida as páginas
Agrupe as consultas em intenções, depois aplique as regras de página: uma página por intenção, uma página de serviço por serviço de dinheiro, páginas de local apenas para áreas atendidas com conteúdo distinto, uma verificação explícita de canibalização e uma decisão de manter, mesclar, redirecionar ou aposentar para cada URL existente com tráfego ou links. Use a oferta e o posicionamento existentes do cérebro como quadro. Regras e testes: references/page-rules.md.
Concluído quando cada intenção mapeia para uma página ou none com um motivo, e cada URL existente com tráfego ou links tem uma ação de migração.
7. Especifique cada página
Para cada página: URL, tag de título, H1, propósito, intenção alvo e sua evidência, esboço de seção, CTA primário, prova real do cérebro (ou um marcador LACUNA:), links internos e tipo de esquema. Em seguida, escreva site-plan.md e sitemap.csv e execute o validador em modo rascunho:
bun $SKILL/scripts/check-site-plan.ts <project>/site-plan --draft
Concluído quando a verificação de rascunho passa.
8. Ciclo de aprovação
Mostre a árvore do sitemap, depois as especificações das páginas em lotes de três ou quatro. Para cada página que o usuário aprova, edita ou remove; aplique as edições, reexecute a verificação de rascunho e mostre a mudança. Registre cada decisão com sua data em decisions.md. Repita até que o usuário aprove todo o plano.
Concluído quando a decisão mais recente de cada página e o próprio plano estão aprovados.
9. Salve e entregue
Escreva os arquivos finais (site-plan.md, decisions.md, sitemap.csv, research/), defina state.json como aprovado e execute a verificação completa:
bun $SKILL/scripts/check-site-plan.ts <project>/site-plan
Adicione uma entrada datada às notas do projeto (docs/project.md ou equivalente; pergunte antes de criar uma): o que foi planejado, onde está, o resultado da verificação e o próximo passo, normalmente mos-atomic-design-system. Se o projeto do site já for um repositório git, prepare os arquivos de planejamento por caminho explícito e faça commit; nunca prepare segredos, arquivos .env ou respostas brutas de ferramentas, e nunca faça push. Regras de commit: references/output-format.md.
Termine com: o que mudou, a saída da verificação, lacunas e bloqueios abertos, e a próxima ação exata. Relate uma verificação como aprovada apenas quando ela foi executada e aprovada nesta sessão.
Mapa de referência
| Arquivo | Leia quando |
|---|---|
references/interview.md | Etapas 2 a 4: o cartão, o banco de perguntas, o loteamento e a reprodução do briefing |
references/research.md | Etapas 1 e 5: detecção de ferramentas, cada método de pesquisa, fallbacks e custos |
references/page-rules.md | Etapa 6: agrupamento de intenções, páginas de local, canibalização, mapa de migração |
references/output-format.md | Etapas 7 a 9: os formatos que o validador impõe, estado, decisões e commits |
assets/ | Templates iniciais para cada arquivo de saída |
scripts/check-site-plan.ts | --help; execute nas etapas 7 a 9 |
scripts/test-check-site-plan.ts | Prova de que o validador falha em cada plano quebrado |
Habilidades relacionadas
Acompanhamentos opcionais do pacote MarketingOS GEO (mos-geo-skills), nomeados aqui e instalados separadamente: mos-geo-topic-clusters para agrupar uma grande exportação do Search Console ou Ahrefs antes da etapa 6, mos-geo-brand-360 para a verificação de respostas de IA, e mos-geo-fan-out-map assim que o site estiver no ar.