site-architecture

Visão geral da skill site-architecture

O que a skill site-architecture faz

A skill site-architecture ajuda você a planejar ou reorganizar a hierarquia de páginas de um site, a navegação, a estrutura de URLs e a malha de links internos. Ela foi feita para trabalho de arquitetura da informação, não para geração técnica de XML sitemap. Se a sua pergunta real é “quais páginas este site deve ter, como elas devem se conectar e como os usuários devem navegar por elas?”, esta é a skill certa.

Quem deve usar a site-architecture

A skill site-architecture é mais indicada para:

• marketers planejando um novo site ou uma grande reestruturação
• founders definindo o site de marketing de um SaaS
• equipes de UI/UX trabalhando em navegação e arquitetura da informação
• times de conteúdo com visão de SEO decidindo hubs, seções e relações entre páginas
• agências que precisam de uma primeira versão rápida de sitemap, mapa de URLs e especificação de navegação

Ela é especialmente útil quando o site cresceu de forma orgânica e agora parece difícil de navegar, inconsistente ou profundo demais.

Casos de uso mais aderentes

Use site-architecture quando você precisar:

• transformar uma lista inicial de páginas em um mapa de site lógico
• decidir entre uma estrutura mais rasa ou mais profunda
• definir navegação de header, footer e seções
• criar padrões de URL para seções como /features, /compare ou /integrations
• melhorar os links internos entre páginas hub e páginas de detalhe
• gerar um sitemap visual em ASCII ou Mermaid para revisão

O que diferencia esta skill de um prompt genérico

Um prompt genérico pode listar páginas. A site-architecture é mais forte porque empurra o trabalho para um conjunto de entregáveis mais completo:

• contexto de negócio e público primeiro
• desenho explícito da hierarquia
• recomendações de navegação
• padrões de estrutura de URL
• orientação de links internos
• saídas visuais de sitemap
• templates reutilizáveis para tipos comuns de site

O repositório também inclui referências práticas para diagramas em Mermaid, padrões de navegação e templates por tipo de site, o que torna a saída mais consistente do que começar do zero.

Limites importantes de escopo

Esta skill não cobre principalmente:

• arquivos de XML sitemap
• auditorias completas de SEO
• schema markup
• wireframes finais ou mockups de UI refinados

Para site-architecture for UI/UX Design, ela é mais útil na camada estrutural: agrupamento de páginas, orientação de navegação, zonas de navegação e encontrabilidade de conteúdo antes do design detalhado da interface.

Como usar a skill site-architecture

Contexto de instalação e forma de acesso

Instale a skill a partir do repositório com:

npx skills add https://github.com/coreyhaines31/marketingskills --skill site-architecture

Na prática, os usuários acionam site-architecture ao pedir ajuda com sitemaps, navegação, hierarquia de páginas ou planejamento de URLs. Ela funciona melhor em uma configuração de agente compatível com Skills, em que o modelo pode ler os arquivos da skill e seguir o workflow.

Leia estes arquivos primeiro antes de usar a site-architecture

Se você quiser avaliar a skill rapidamente, comece por aqui:

1. skills/site-architecture/SKILL.md
2. skills/site-architecture/references/site-type-templates.md
3. skills/site-architecture/references/navigation-patterns.md
4. skills/site-architecture/references/mermaid-templates.md
5. skills/site-architecture/evals/evals.json

Essa ordem de leitura mostra o workflow, os outputs mais comuns, opções concretas de navegação, formatos de diagrama e o que é considerado “bom” nas avaliações.

O input mais importante de que a skill precisa

A site-architecture fica muito melhor quando você fornece:

• o que a empresa faz
• públicos principais
• principais objetivos do site, normalmente no máximo 2-3
• se é um site novo ou uma reestruturação
• inventário de páginas existente, se houver
• áreas problemáticas, como duplicação, profundidade excessiva ou baixa encontrabilidade
• tipo de site, como SaaS, ecommerce, serviços, marketplace ou site com muito conteúdo

Se você omitir isso, o modelo ainda pode rascunhar uma estrutura, mas ela tende a ficar genérica e pode escolher o padrão de navegação errado.

Verifique primeiro o contexto de product marketing

Um comportamento útil e específico deste repo: a skill instrui explicitamente o agente a verificar .agents/product-marketing-context.md ou o antigo .claude/product-marketing-context.md antes de fazer perguntas. Isso importa porque muitas decisões de arquitetura dependem de posicionamento, públicos e estrutura da oferta.

Se você já tem o contexto de product marketing documentado, aponte o modelo para esse material. Isso reduz idas e vindas repetitivas e melhora as decisões de agrupamento de páginas.

Como transformar um objetivo vago em um prompt forte para site-architecture

Prompt fraco:

Help me make a sitemap.

Prompt mais forte:

Use the site-architecture skill to plan a SaaS marketing site for an analytics product aimed at ecommerce teams. Our goals are demo requests, SEO traffic, and partner integrations. We need a homepage, pricing, feature pages, docs, blog, integrations, and competitor comparison pages. Keep top nav to 5-6 primary items. Propose page hierarchy, URL structure, header/footer nav, and internal linking model.

Por que isso funciona:

• define público e tipo de negócio
• explicita metas de conversão e de conteúdo
• lista os tipos de conteúdo necessários
• adiciona uma restrição de navegação
• pede entregáveis concretos para os quais a skill foi desenhada

Como é um bom uso da site-architecture

Peça o output nesta ordem:

1. premissas e inputs ausentes
2. hierarquia proposta
3. mapa de URLs
4. especificação de navegação
5. recomendações de links internos
6. árvore em ASCII ou diagrama Mermaid
7. tradeoffs ou questões em aberto

Isso espelha os pontos fortes práticos da skill. Também ajuda você a revisar a estrutura antes de discutir labels ou detalhes de design.

Use os templates de referência em vez de começar do zero

O maior atalho para adoção está no conjunto de referências:

• site-type-templates.md traz padrões prontos de hierarquia
• navigation-patterns.md ajuda a escolher entre header simples, mega menu e outros modelos de navegação
• mermaid-templates.md acelera a criação de sitemaps visuais

Para muitas equipes, o melhor workflow é: escolher o template de site mais próximo, adaptar as seções e depois refinar navegação e URLs. Isso é mais rápido e, na maioria dos casos, melhor do que trabalhar com prompts totalmente abertos.

Workflow recomendado para um site novo

Para uma nova construção:

1. defina objetivos de negócio e públicos
2. escolha o template de tipo de site mais próximo
3. ajuste as seções principais
4. estabeleça convenções de URL
5. limite a navegação do header aos itens prioritários
6. distribua páginas de apoio entre footer e navegação de seção
7. adicione links internos no modelo hub-and-spoke quando fizer sentido
8. exporte uma árvore em ASCII ou um diagrama Mermaid para revisão com stakeholders

Isso funciona especialmente bem para SaaS, em que seções como /features, /customers, /resources, /integrations e /compare normalmente precisam de separação clara.

Workflow recomendado para uma reestruturação

Para um site existente e bagunçado, forneça ao modelo:

• navegação atual
• quantidade de páginas ou inventário
• seções duplicadas
• páginas com tráfego ruim ou ownership pouco claro
• reclamações de usuários, como “não consigo achar a documentação” ou “há dropdowns demais”

Depois, peça que ele:

• consolide seções
• elimine pontos de entrada duplicados
• reduza profundidade desnecessária
• separe a navegação principal dos itens utilitários e de footer
• preserve, quando possível, URLs legadas de alto valor

É aqui que a site-architecture é mais útil do que um prompt genérico de brainstorming, porque ela enquadra o trabalho como reorganização, e não apenas como uma lista de páginas.

site-architecture para equipes de UI/UX Design

Para UI/UX Design, use a skill antes dos wireframes quando precisar esclarecer:

• o que deve entrar na navegação global
• onde páginas de entrada de seção são necessárias
• como os breadcrumbs devem refletir a hierarquia
• quais páginas merecem acesso direto versus indireto
• quando um mega menu se justifica

Ela não substitui interaction design, mas dá às equipes de UI/UX uma base de arquitetura da informação mais defensável antes de desenhar componentes.

Formatos de output práticos para pedir

A skill é mais forte quando você pede um ou mais destes formatos:

• árvore em ASCII para revisão rápida
• sitemap em Mermaid para documentação
• tabela de mapa de URLs com prioridades
• especificação de navegação de header/footer
• modelo de links internos por seção

Todos esses formatos são sustentados pelas evidências do repositório, então você está alinhando seu pedido ao que a skill já faz bem.

FAQ da skill site-architecture

A site-architecture é boa para iniciantes?

Sim, desde que você já conheça os objetivos do site e os principais tipos de conteúdo. A skill entrega estrutura mais rápido do que inventar uma arquitetura da informação do zero. Iniciantes normalmente têm dificuldade quando fornecem contexto demais? Não — o problema costuma ser contexto de menos, e não o fato de a skill ser avançada demais.

Quando devo usar a site-architecture em vez de um prompt normal?

Use a site-architecture quando o output precisar ser operacional: hierarquia, navegação, regras de URL e estratégia de links. Um prompt normal pode fazer brainstorming de páginas, mas esta skill é melhor quando você precisa de um artefato de arquitetura passível de revisão.

A site-architecture cria XML sitemaps?

Não. Esta skill é voltada para arquitetura da informação e planejamento de navegação. Ela não é a ferramenta certa para geração de XML sitemap nem para diagnósticos técnicos de crawl.

A site-architecture é útil para sites existentes, e não só para novos?

Sim. Ela se encaixa muito bem em reestruturações, especialmente quando o site tem páginas demais, agrupamentos inconsistentes ou navegação confusa. Forneça o estado atual e os pontos de dor, não apenas o estado futuro desejado.

Como ela se compara a fazer IA manualmente?

O trabalho manual de arquitetura da informação continua valioso, mas esta skill acelera a primeira passada estrutural e oferece templates reutilizáveis. Ela é mais útil para rascunhar opções, expor tradeoffs e produzir artefatos para revisão em equipe. Você ainda precisa de julgamento humano para lidar com política interna, ownership e restrições de implementação.

Ela é uma boa opção para site-architecture for UI/UX Design?

Sim, como ferramenta de planejamento upstream. Ela ajuda equipes de UI/UX Design a definir relações entre páginas, profundidade de navegação e lógica de orientação antes dos layouts detalhados. É menos indicada para decisões de design no nível de componentes.

Quando a site-architecture é a skill errada?

Evite usá-la se a sua necessidade real for:

• auditoria técnica de SEO
• planejamento de schema
• redação de conteúdo
• wireframing de layouts de página em alta fidelidade
• arquitetura da informação de produto/app muito além de padrões de sites de marketing

Ela também é uma escolha fraca se você não consegue fornecer contexto básico de negócio.

Como melhorar a skill site-architecture

Dê restrições de negócio mais precisas

A forma mais rápida de melhorar o output da site-architecture é explicitar restrições:

• ação principal de conversão
• principais segmentos de público
• número máximo de itens na navegação do header
• seções obrigatórias
• seções que devem ficar fora da navegação principal
• se páginas de aterrissagem para SEO são prioridade

Sem restrições, o modelo tende a incluir páginas demais e priorizar de menos a navegação.

Forneça um inventário de páginas para reestruturações

Para sites existentes, cole um inventário básico de páginas ou a navegação atual. Mesmo uma lista bagunçada já ajuda. Isso permite que a site-architecture identifique oportunidades de consolidação, estruturas duplicadas e seções órfãs que, de outro modo, passariam despercebidas.

Peça tradeoffs, não apenas uma resposta

Um padrão forte de melhoria é:

Give me a recommended architecture plus one simpler option and one SEO-expansion option.

Isso traz à tona decisões reais, como:

• navegação simples vs navegação escalável
• menos seções de topo vs hubs dedicados de landing pages
• hierarquia mais rasa vs categorização mais clara

Isso torna a skill mais útil para alinhamento com stakeholders.

Force mais clareza no output com entregáveis específicos

Se a primeira saída parecer vaga, peça:

• uma árvore ASCII completa
• padrões exatos de URL
• labels de navegação com contagem de itens
• exemplos de breadcrumbs
• links internos no nível de seção

Formatos específicos reduzem recomendações genéricas e tornam o guia de site-architecture mais pronto para implementação.

Modos de falha comuns para observar

Fique atento a estes problemas nos primeiros rascunhos:

• itens demais na navegação de topo
• nomes de categoria que se sobrepõem
• hubs de conteúdo misturados com páginas de conversão sem prioridade clara
• profundidade excessiva com pouco benefício para o usuário
• blog/resources/docs agrupados de forma inconsistente
• landing pages de SEO adicionadas sem um plano de links

Esses são problemas comuns de arquitetura da informação que a skill pode introduzir se o seu prompt estiver amplo ou ambíguo.

Melhore as recomendações de links internos

Não aceite “add internal links” como suficiente. Peça ao modelo para especificar:

• quais páginas hub linkam para quais páginas de detalhe
• quais páginas de detalhe linkam de volta para os hubs
• onde links cruzados fazem sentido, como de features para integrations ou de comparisons para pricing
• quais páginas devem ficar fora de uma malha intensa de links cruzados

Isso faz o uso da site-architecture sair do conceitual e virar algo acionável.

Use as referências do repo para fortalecer rascunhos fracos

Se o output parecer genérico, direcione o modelo a aplicar:

• references/navigation-patterns.md para decisões de navegação
• references/site-type-templates.md para cobertura de seções
• references/mermaid-templates.md para diagramas mais claros

Esta é uma das formas mais fáceis de melhorar a site-architecture sem alterar a skill em si.

Itere depois da primeira passada de arquitetura

Uma boa prática é fazer um prompt de segunda rodada como:

Revise this site architecture to reduce header nav to 5 items, move low-priority pages to footer, preserve our existing /blog structure, and create a clearer hub model for integrations and comparison pages.

Esse tipo de revisão direcionada costuma ser o ponto em que a skill se torna realmente útil em contexto de produção.

Valide a estrutura com jornadas reais de usuário

Antes de adotar o output, teste se as jornadas principais são fáceis:

• visitante de primeira viagem até entender o produto
• usuário comparando opções até a página de decisão
• visitante vindo de SEO a partir de um artigo até intenção de produto
• cliente existente até docs ou suporte
• potencial parceiro até detalhes de integrations

Se essas jornadas parecerem truncadas, a site-architecture precisa de mais uma iteração, mesmo que o sitemap pareça limpo.

Melhore a site-architecture reduzindo a amplitude do público

Públicos amplos criam uma arquitetura confusa. Se o primeiro output tentar atender todo mundo ao mesmo tempo, divida prioridades:

• buyer vs user
• SMB vs enterprise
• prospect vs customer
• conteúdo educativo vs conteúdo de conversão

A site-architecture melhora bastante quando a prioridade de público fica clara, porque a navegação e o agrupamento de páginas ficam muito mais fáceis de defender.