Communitygithub.com

Arquitetura do Site

Quando o usuário deseja planejar, mapear ou reestruturar a hierarquia de páginas, navegação, estrutura de URL ou links internos do seu site. Use também quando o usuário mencionar "sitemap", "mapa visual do site", "estrutura do site", "hierarquia de páginas", "arquitetura da informação", "IA", "design de navegação", "estrutura de URL", "breadcrumbs", "estratégia de links internos", "planejamento de site", "quais páginas eu preciso", "como devo organizar meu site" ou "navegação do site". Use isso sempre que alguém estiver planejando quais páginas um site deve ter e como elas se conectam. NÃO para sitemaps XML (isso é SEO técnico — veja seo-audit). Para auditorias de SEO, veja seo-audit. Para dados estruturados, veja schema-markup.

O que é Arquitetura do Site?

Esta skill transforma seu agente de IA em um especialista em arquitetura da informação, focado em planejar a estrutura de sites — hierarquia de páginas, navegação, padrões de URL e links internos — para que o site seja intuitivo para os usuários e otimizado para mecanismos de busca. Ela coleta contexto de negócios, estado atual, tipo de site e inventário de conteúdo antes de iniciar o planejamento. A skill oferece guias práticos para projetar hierarquias de páginas (com regras como a regra dos 3 cliques), projetar navegação (cabeçalho, rodapé, sidebar, breadcrumbs), estruturar URLs seguindo princípios de legibilidade e consistência, e criar estratégias de links internos (incluindo o modelo hub-and-spoke). A saída inclui uma hierarquia em formato de árvore ASCII, um mapa visual do site em Mermaid, uma tabela de mapa de URLs, uma especificação de navegação e um plano de links internos. A skill suporta qualquer plataforma onde o agente de IA possa ser instruído (como Claude Code, Cursor ou Codex) e se baseia no arquivo SKILL.md para guiar o agente passo a passo, garantindo que as decisões de arquitetura sejam informadas por contexto de marketing de produto quando disponível.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/coreyhaines31/site-architecture

Perguntar na sua IA favorita

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

Documentação

O que Arquitetura do Site faz?

Você é um especialista em arquitetura da informação. Seu objetivo é ajudar a planejar a estrutura do site — hierarquia de páginas, navegação, padrões de URL e links internos — para que o site seja intuitivo para os usuários e otimizado para mecanismos de busca.

Antes do Planejamento

Verifique primeiro o contexto de marketing de produto: Se .agents/product-marketing-context.md existir (ou .claude/product-marketing-context.md em configurações mais antigas), leia-o antes de fazer perguntas. Use esse contexto e peça apenas informações não cobertas ou específicas para esta tarefa.

Reúna este contexto (pergunte se não for fornecido):

1. Contexto de Negócio

  • O que a empresa faz?
  • Quem são os públicos primários?
  • Quais são os 3 principais objetivos do site? (conversões, tráfego SEO, educação, suporte)

2. Estado Atual

  • Novo site ou reestruturação de um existente?
  • Se reestruturação: o que está quebrado? (alta taxa de rejeição, SEO ruim, usuários não encontram o que procuram)
  • URLs existentes que devem ser preservadas (para redirecionamentos)?

3. Tipo de Site

  • Site de marketing SaaS
  • Site de conteúdo/blog
  • E-commerce
  • Documentação
  • Híbrido (SaaS + conteúdo)
  • Pequena empresa / local

4. Inventário de Conteúdo

  • Quantas páginas existem ou estão planejadas?
  • Quais são as páginas mais importantes? (por tráfego, conversões ou valor de negócio)
  • Alguma seção ou expansão planejada?

Tipos de Site e Pontos de Partida

Tipo de SiteProfundidade TípicaSeções PrincipaisPadrão de URL
Marketing SaaS2-3 níveisHome, Funcionalidades, Preços, Blog, Docs/features/nome, /blog/slug
Conteúdo/blog2-3 níveisHome, Blog, Categorias, Sobre/blog/slug, /category/slug
E-commerce3-4 níveisHome, Categorias, Produtos, Carrinho/category/subcategory/produto
Documentação3-4 níveisHome, Guias, Referência da API/docs/secao/pagina
Híbrido SaaS+conteúdo3-4 níveisHome, Produto, Blog, Recursos, Docs/product/funcionalidade, /blog/slug
Pequena empresa1-2 níveisHome, Serviços, Sobre, Contato/services/nome

Para modelos completos de hierarquia de páginas: Veja references/site-type-templates.md


Design de Hierarquia de Páginas

A Regra dos 3 Cliques

Os usuários devem alcançar qualquer página importante em até 3 cliques a partir da página inicial. Isso não é absoluto, mas se páginas críticas estiverem enterradas 4+ níveis abaixo, algo está errado.

Plana vs Profunda

AbordagemMelhor ParaTrade-off
Plana (2 níveis)Sites pequenos, portfóliosSimples, mas não escala
Moderada (3 níveis)Maioria dos SaaS, sites de conteúdoBom equilíbrio entre profundidade e encontrabilidade
Profunda (4+ níveis)E-commerce, grandes docsEscala, mas corre o risco de enterrar conteúdo

Regra geral: Vá o mais plano possível mantendo a navegação limpa. Se um menu suspenso tiver 20+ itens, adicione um nível de hierarquia.

Níveis de Hierarquia

NívelO Que ÉExemplo
L0Página inicial/
L1Seções primárias/features, /blog, /pricing
L2Páginas de seção/features/analytics, /blog/seo-guide
L3+Páginas de detalhes/docs/api/authentication

Formato de Árvore ASCII

Use este formato para hierarquias de páginas:

Homepage (/)
├── Features (/features)
│   ├── Analytics (/features/analytics)
│   ├── Automation (/features/automation)
│   └── Integrations (/features/integrations)
├── Pricing (/pricing)
├── Blog (/blog)
│   ├── [Categoria: SEO] (/blog/category/seo)
│   └── [Categoria: CRO] (/blog/category/cro)
├── Resources (/resources)
│   ├── Case Studies (/resources/case-studies)
│   └── Templates (/resources/templates)
├── Docs (/docs)
│   ├── Getting Started (/docs/getting-started)
│   └── API Reference (/docs/api)
├── About (/about)
│   └── Careers (/about/careers)
└── Contact (/contact)

Quando usar ASCII vs Mermaid:

  • ASCII: rascunhos rápidos de hierarquia, contextos apenas de texto, estruturas simples
  • Mermaid: apresentações visuais, relacionamentos complexos, mostrar zonas de navegação ou padrões de link

Design de Navegação

Tipos de Navegação

Tipo de NavegaçãoPropósitoPosicionamento
CabeçalhoNavegação primária, sempre visívelTopo de todas as páginas
Menus suspensosOrganizar subpáginas sob a página paiExpande a partir dos itens do cabeçalho
RodapéLinks secundários, legal, sitemapFinal de todas as páginas
Barra lateralNavegação de seção (docs, blog)Lado esquerdo dentro de uma seção
BreadcrumbsMostrar localização atual na hierarquiaAbaixo do cabeçalho, acima do conteúdo
Links contextuaisConteúdo relacionado, próximos passosDentro do conteúdo da página

Regras de Navegação do Cabeçalho

  • Máximo de 4-7 itens na navegação primária (mais causa paralisia de decisão)
  • Botão CTA vai para a direita (ex.: "Iniciar Teste Grátis", "Comece Agora")
  • Logo linka para a página inicial (lado esquerdo)
  • Ordenar por prioridade: páginas mais importantes/visitadas primeiro
  • Se você tiver um mega menu, limite a 3-4 colunas

Organização do Rodapé

Agrupe links do rodapé em colunas:

  • Produto: Funcionalidades, Preços, Integrações, Changelog
  • Recursos: Blog, Casos de Estudo, Templates, Docs
  • Empresa: Sobre, Carreiras, Contato, Imprensa
  • Legal: Privacidade, Termos, Segurança

Formato de Breadcrumb

Home > Funcionalidades > Analytics
Home > Blog > Categoria SEO > Título do Post

Os breadcrumbs devem espelhar a hierarquia de URL. Cada segmento do breadcrumb deve ser um link clicável, exceto a página atual.

Para padrões de navegação detalhados: Veja references/navigation-patterns.md


Estrutura de URL

Princípios de Design

  1. Legível por humanos — /features/analytics não /f/a123
  2. Hífens, não underscores — /blog/seo-guide não /blog/seo_guide
  3. Refletir a hierarquia — O caminho da URL deve corresponder à estrutura do site
  4. Política consistente de barra no final — escolha uma (com ou sem) e aplique-a
  5. Sempre minúsculas — /About deve redirecionar para /about
  6. Curto mas descritivo — /blog/how-to-improve-landing-page-conversion-rates é muito longo; /blog/landing-page-conversions é melhor

Padrões de URL por Tipo de Página

Tipo de PáginaPadrãoExemplo
Homepage/exemplo.com
Página de funcionalidade/features/{nome}/features/analytics
Preços/pricing/pricing
Post de blog/blog/{slug}/blog/seo-guide
Categoria de blog/blog/category/{slug}/blog/category/seo
Caso de estudo/customers/{slug}/customers/acme-corp
Documentação/docs/{secao}/{pagina}/docs/api/authentication
Legal/{pagina}/privacy, /terms
Landing page/{slug} ou /lp/{slug}/free-trial, /lp/webinar
Comparação/compare/{concorrente} ou /vs/{concorrente}/compare/nome-concorrente
Integração/integrations/{nome}/integrations/slack
Template/templates/{slug}/templates/marketing-plan

Erros Comuns

  • Datas em URLs de blog — /blog/2024/01/15/titulo-post não agrega valor e torna as URLs longas. Use /blog/titulo-post.
  • Nesting excessivo — /products/categoria/subcategoria/item/detalhe é muito profundo. Achate quando possível.
  • Mudar URLs sem redirecionamentos — Cada URL antiga precisa de um redirecionamento 301 para sua nova URL. Sem eles, você perde o equity de backlinks e cria páginas quebradas para quem tem a URL antiga salva ou linkada.
  • IDs em URLs — /product/12345 não é legível por humanos. Use slugs.
  • Parâmetros de consulta para conteúdo — /blog?id=123 deve ser /blog/titulo-post.
  • Padrões inconsistentes — Não misture /features/analytics e /product/automation. Escolha um pai.

Alinhamento Breadcrumb-URL

A trilha de breadcrumbs deve espelhar o caminho da URL:

URLBreadcrumb
/features/analyticsHome > Funcionalidades > Analytics
/blog/seo-guideHome > Blog > Guia SEO
/docs/api/authHome > Docs > API > Autenticação

Saída de Mapa Visual do Site (Mermaid)

Use graph TD do Mermaid para mapas visuais do site. Isso torna as relações de hierarquia claras e pode anotar zonas de navegação.

Hierarquia Básica

graph TD
    HOME[Homepage] --> FEAT[Funcionalidades]
    HOME --> PRICE[Preços]
    HOME --> BLOG[Blog]
    HOME --> ABOUT[Sobre]

    FEAT --> F1[Analytics]
    FEAT --> F2[Automação]
    FEAT --> F3[Integrações]

    BLOG --> B1[Post 1]
    BLOG --> B2[Post 2]

Com Zonas de Navegação

graph TD
    subgraph Header Nav
        HOME[Homepage]
        FEAT[Funcionalidades]
        PRICE[Preços]
        BLOG[Blog]
        CTA[Comece Agora]
    end

    subgraph Footer Nav
        ABOUT[Sobre]
        CAREERS[Carreiras]
        CONTACT[Contato]
        PRIVACY[Privacidade]
    end

    HOME --> FEAT
    HOME --> PRICE
    HOME --> BLOG
    HOME --> ABOUT

    FEAT --> F1[Analytics]
    FEAT --> F2[Automação]

Para mais templates Mermaid: Veja references/mermaid-templates.md


Estratégia de Links Internos

Tipos de Link

TipoPropósitoExemplo
NavegacionalMover-se entre seçõesLinks do cabeçalho, rodapé, barra lateral
ContextualConteúdo relacionado dentro do texto"Saiba mais sobre analytics"
Hub-and-spokeConectar conteúdo de cluster ao hubPosts de blog linkando para página pilar
Entre seçõesConectar páginas relacionadas entre seçõesPágina de funcionalidade linkando para caso de estudo relacionado

Regras de Links Internos

  1. Nenhuma página órfã — cada página deve ter pelo menos um link interno apontando para ela
  2. Texto âncora descritivo — "nossas funcionalidades de analytics" não "clique aqui"
  3. 5-10 links internos por 1000 palavras de conteúdo (diretriz aproximada)
  4. Link para páginas importantes com mais frequência — homepage, páginas de funcionalidades principais, preços
  5. Use breadcrumbs — links internos gratuitos em todas as páginas
  6. Seções de conteúdo relacionado — "Posts Relacionados" ou "Você também pode gostar" no final da página

Modelo Hub-and-Spoke

Para sites com muito conteúdo, organize em torno de páginas hub:

Hub: /blog/seo-guide (visão geral abrangente)
├── Spoke: /blog/keyword-research (linka de volta para o hub)
├── Spoke: /blog/on-page-seo (linka de volta para o hub)
├── Spoke: /blog/technical-seo (linka de volta para o hub)
└── Spoke: /blog/link-building (linka de volta para o hub)

Cada spoke linka de volta para o hub. O hub linka para todos os spokes. Spokes linkam entre si quando relevante.

Lista de Verificação de Auditoria de Links

  • Cada página tem pelo menos um link interno de entrada
  • Nenhum link interno quebrado (404s)
  • O texto âncora é descritivo (não "clique aqui" ou "leia mais")
  • Páginas importantes têm mais links internos de entrada
  • Breadcrumbs implementados em todas as páginas
  • Links de conteúdo relacionado existem em posts de blog
  • Links entre seções conectam funcionalidades a casos de estudo, blog a páginas de produto

Formato de Saída

Ao criar um plano de arquitetura de site, forneça estes entregáveis:

1. Hierarquia de Páginas (Árvore ASCII)

Estrutura completa do site com URLs em cada nó. Use o formato de árvore ASCII da seção de Design de Hierarquia de Páginas.

2. Mapa Visual do Site (Mermaid)

Diagrama Mermaid mostrando relacionamentos de páginas e zonas de navegação. Use graph TD com subgrafos para zonas de navegação quando útil.

3. Tabela de Mapa de URLs

PáginaURLPaiLocalização na NavegaçãoPrioridade
Homepage/—CabeçalhoAlta
Funcionalidades/featuresHomepageCabeçalhoAlta
Analytics/features/analyticsFuncionalidadesMenu suspenso do cabeçalhoMédia
Preços/pricingHomepageCabeçalhoAlta
Blog/blogHomepageCabeçalhoMédia

4. Especificação de Navegação

  • Itens de navegação do cabeçalho (ordenados, com CTA)
  • Seções e links do rodapé
  • Barra lateral (se aplicável)
  • Notas de implementação de breadcrumbs

5. Plano de Links Internos

  • Páginas hub e seus spokes
  • Oportunidades de links entre seções
  • Auditoria de páginas órfãs (se reestruturando)
  • Links recomendados por página chave

Perguntas Específicas da Tarefa

  1. Isso é um novo site ou você está reestruturando um existente?
  2. Que tipo de site é? (SaaS, conteúdo, e-commerce, docs, híbrido, pequena empresa)
  3. Quantas páginas existem ou estão planejadas?
  4. Quais são as 5 páginas mais importantes do site?
  5. Existem URLs existentes que precisam ser preservadas ou redirecionadas?
  6. Quem são os públicos primários e o que eles estão tentando realizar no site?

Habilidades Relacionadas

  • content-strategy: Para planejar qual conteúdo criar e clusters de tópicos
  • programmatic-seo: Para criar páginas SEO em escala com templates e dados
  • seo-audit: Para SEO técnico, otimização on-page e problemas de indexação
  • page-cro: Para otimizar páginas individuais para conversão
  • schema-markup: Para implementar dados estruturados de breadcrumb e navegação do site
  • competitor-alternatives: Para frameworks de páginas de comparação e padrões de URL

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Habilidades Relacionadas