Site Architecture

Site Architecture

When the user wants to audit, redesign, or plan their website's structure, URL hierarchy, navigation design, or internal linking strategy. Use when th

Category: content-creation Source: alirezarezvani/claude-skills

What Is Site Architecture?

Site architecture refers to the way a website’s pages are structured, organized, and linked together. It encompasses the planning and design of URL hierarchies, navigation menus, internal linking strategies, and the overall information architecture of the site. Effective site architecture ensures that both users and search engines can easily find content, understand site relationships, and traverse the website efficiently. It plays a critical role in technical SEO, user experience, and long-term site scalability.

Why Use Site Architecture?

Implementing thoughtful site architecture is vital for several reasons:

  • User Experience: Clear navigation and logical structure allow visitors to find information quickly, reducing bounce rates and increasing engagement.
  • SEO Performance: Search engines rely on internal links and sitemaps to crawl and index content. Well-designed architecture enhances crawlability, distributes PageRank, and helps establish topical authority.
  • Scalability: A well-structured site can grow smoothly as new sections or content are added, minimizing future rework.
  • Issue Prevention: Proper architecture prevents common problems like orphan pages (pages with no internal links), duplicate content, and inefficient crawl paths.
  • Business Goals: Aligning architecture with business priorities ensures that key products, services, or content receive appropriate visibility and traffic.

How to Get Started

To begin auditing, redesigning, or planning your site’s architecture with the Claude Code “Site Architecture” skill, follow these steps:

  1. Assess the Current State:

    • Determine if there’s an existing site and gather its URL, CMS type, and sitemap.xml if available.
    • Estimate the number of pages, grouped by major sections (e.g., blog, products, categories).
    • Identify top-performing pages and any known issues such as orphan pages, duplicate content, or poor rankings.

  2. Define Business Goals:

    • Clarify the site’s primary purpose (e.g., lead generation, e-commerce, informational).
    • Establish which sections or pages are most critical for success.

  3. Map the Existing Structure:

    • Visualize the current hierarchy using diagrams or lists.
    • Example: a simple tree structure for a product site:
      /
├── /products/
│   ├── /products/category-1/
│   │   ├── /products/category-1/product-a/
│   │   └── /products/category-1/product-b/
│   └── /products/category-2/
└── /blog/
    ├── /blog/topic-1/
    └── /blog/topic-2/

  4. Identify Gaps and Opportunities:

    • Look for pages that are hard to reach or not linked internally (orphan pages).
    • Assess whether the current navigation reflects user intent and search demand.

  5. Plan Improvements:

    • Propose a revised structure, navigation, and internal linking strategy aligned with goals.

Key Features

The Claude Code “Site Architecture” skill offers several core capabilities:

  • Structure Auditing: Analyze existing site organization, identifying issues like deep nesting, unnecessary duplication, or disconnected pages.
  • URL Hierarchy Design: Recommend clean, descriptive, and SEO-friendly URL structures.
  • Navigation Optimization: Advise on designing intuitive menus, breadcrumbs, and contextual navigation that aid user journeys.
  • Internal Linking Strategy: Suggest ways to implement hub pages, topic clusters, and contextual links that boost topical authority and spread link equity.
  • Silo Structure Planning: Help group related content to reinforce relevance and improve both user and search engine understanding.
  • Orphan Page Detection: Highlight pages lacking internal links, with code examples for detection (e.g., in Python):
    # Example: Detect orphan pages from sitemap and crawled URLs
sitemap_urls = set(load_sitemap('sitemap.xml'))
crawled_urls = set(get_all_internal_links('https://example.com'))
orphan_pages = sitemap_urls - crawled_urls
print("Orphan pages:", orphan_pages)
  • Breadcrumb & Navigation Logic: Provide recommendations on implementing breadcrumbs for better usability and crawlability.

Best Practices

  • Shallow Hierarchy: Keep important pages within 3 clicks from the homepage. Deeply nested structures can harm SEO and user experience.
  • Consistent URLs: Use descriptive, hyphen-separated URLs. Avoid unnecessary parameters or session IDs.
  • Logical Navigation: Main menus should reflect primary site sections. Use secondary navigation for subcategories.
  • Comprehensive Internal Links: Every important page should be linked from at least one other relevant page. Hub pages can link to clusters of related content.
  • Breadcrumbs: Implement breadcrumbs for multi-level sites to improve navigation and help search engines understand page context.
  • Topic Clusters: Group related articles or products around central hub pages to build topical authority.
  • Monitor for Orphans: Regularly audit for orphan pages using automated scripts or crawling tools.

Important Notes

  • The “Site Architecture” skill is not intended for making content strategy decisions (what topics to create or write about) or for generating schema markup. Use the corresponding content-strategy or schema-markup skills for those tasks.
  • Always gather current marketing context and business goals before proposing major structural changes.
  • Site architecture changes can significantly impact SEO—validate recommendations with crawl simulations and, where possible, test in staging before deploying to production.
  • For large or legacy sites, plan for redirects and careful URL migration to avoid traffic loss.
  • Regularly review analytics and search console data to ensure architectural changes are delivering intended results.