Communitygithub.com

mos-design-site-planner

Planeje um site para pequenas empresas antes de qualquer construção: um briefing de site com fontes, um mapa de intenção de pesquisa e um sitemap com especificações para cada página (URL, título, H1, seções, CTA, provas), construído a partir do cérebro ativo do MarketingOS, uma entrevista apenas com lacunas e pesquisa rotulada como medida, observada ou presumida. Para no plano aprovado, salvo no projeto do site. Use para plano de site, sitemap, plano do site, arquitetura da informação, mapa de intenção de pesquisa, plano de página ou lição 2.1 Planejar o Site. Não para construir páginas, sistemas de design (mos-atomic-design-system), redação ou executar uma migração.

O que é mos-design-site-planner?

O **mos-design-site-planner** é uma habilidade especializada para Agentes de IA (como Claude Code e Codex) que transforma o conhecimento existente de um negócio, combinado com uma breve entrevista focada em lacunas e pesquisas reais, em um plano de site detalhado e acionável. Ela é ideal para projetos de sites de pequenas empresas e gera como entregáveis um briefing de site com fontes, um mapa de intenção de pesquisa e um sitemap com especificações completas para cada página. A habilidade usa um fluxo de trabalho em nove etapas, desde o reconhecimento do contexto do MarketingOS até a aprovação final e salvamento, com validação automatizada. Cada descoberta de pesquisa é rotulada como **medida** (com dados numéricos), **observada** (vista diretamente) ou **presumida** (baseada em raciocínio), garantindo transparência e rastreabilidade. O **mos-design-site-planner** para no plano aprovado, não construindo páginas, escrevendo cópia final ou configurando redirecionamentos, e pode ser seguido por habilidades de design de sistema atômico ou otimização GEO.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/the-vibe-marketing-lab/mos-design-skills/tree/HEAD/mos-design-site-planner

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

ArquivoLeia quando
references/interview.mdEtapas 2 a 4: o cartão, o banco de perguntas, o loteamento e a reprodução do briefing
references/research.mdEtapas 1 e 5: detecção de ferramentas, cada método de pesquisa, fallbacks e custos
references/page-rules.mdEtapa 6: agrupamento de intenções, páginas de local, canibalização, mapa de migração
references/output-format.mdEtapas 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.tsProva 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas