Site Architecture

Site Architecture & Internal Linking

Production-grade website architecture framework covering URL hierarchy design, internal linking strategy, navigation optimization, silo structure, and crawl equity management. Handles architecture audits, new site planning, and restructuring existing sites.

Table of Contents

• Operating Modes
• URL Structure Design
• Navigation Architecture
• Silo Structure and Topic Clusters
• Internal Linking Strategy
• Crawl Equity Management
• Architecture Audit Framework
• Restructuring Playbook
• Architecture Patterns by Site Type
• Common Mistakes
• Output Artifacts
• Related Skills

Clarify First

Before generating the architecture, confirm these inputs. If any is unknown or vague, ASK — do not assume:

• Operating mode — audit current, plan new, internal-linking optimization, or URL restructuring — determines the artifact produced
• Site type — SaaS, e-commerce, blog/content, local, docs, or marketplace — selects the URL pattern and architecture template
• Core topics / silos — the 3-7 topic clusters the site covers — drives the hub-and-spoke and internal-linking plan
• Current URLs / crawl data — sitemap or URL export — required for audits and redirect mapping

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Operating Modes

Mode 1: Audit Current Architecture

Existing site needs structural assessment. Analyze depth distribution, orphan pages, link equity flow, and navigation effectiveness.

Mode 2: Plan New Architecture

Building from scratch or full redesign. Map business goals to site sections, design URL hierarchy, plan navigation, and define content silos.

Mode 3: Internal Linking Optimization

Structure is fine but link equity flow needs improvement. Identify hub pages, map spoke content, fix orphans, and optimize anchor text.

Mode 4: URL Restructuring

Changing URLs on an existing site. Plan the new structure, build redirect maps, and manage the migration.

URL Structure Design

Depth Guidelines

Decision rule: If the intermediate directory URL (/email-marketing/) will NOT be a real page with its own content and ranking target, do not create the directory. Flat is better than empty hierarchy.

URL Construction Rules

URL Patterns by Site Type

Navigation Architecture

Navigation Zones

Every site has 6 navigation zones. Each serves a different purpose and carries different SEO weight.

Primary Navigation Design

Rules:

• 5-8 items maximum. Cognitive overload starts at 9+ items.
• Every nav item links to a page you actively want to rank.
• Dropdown menus are fine, but the parent item must be a clickable, crawlable link (not just a hover trigger).
• Do not put utility pages (Contact, Privacy, Terms) in primary nav -- they belong in the footer.
• Mobile nav must expose the same structure as desktop nav (no hidden critical pages).

Breadcrumb Implementation

Add breadcrumbs to every non-homepage page. They serve three functions:

1. UX: Show users their location in the hierarchy
2. SEO: Create sitewide upward internal links to hub/category pages
3. Rich results: Enable BreadcrumbList schema for SERP breadcrumbs

Format: Home > Category > Subcategory > Current Page

Rules:

• Every breadcrumb segment must be a real, crawlable link
• Never use breadcrumbs as styled text without links
• Add BreadcrumbList schema markup alongside visible breadcrumbs
• Breadcrumb hierarchy should match URL hierarchy

Silo Structure and Topic Clusters

Hub-and-Spoke Model

A silo is a self-contained cluster of content about one topic, where all pages link to each other and to a central hub page.

                    ┌──────────────────┐
                    │     HUB PAGE     │
                    │   /seo/          │
                    │   (Pillar content)│
                    └────────┬─────────┘
            ┌────────────────┼────────────────┐
       ┌────┴────┐      ┌───┴────┐      ┌────┴────┐
       │ SPOKE 1 │      │ SPOKE 2│      │ SPOKE 3 │
       │technical│      │on-page │      │  link   │
       │  seo    │      │  seo   │      │building │
       └────┬────┘      └───┬────┘      └────┬────┘
            │                │                │
       Cross-links     Cross-links      Cross-links
       between         between          between
       related         related          related
       spokes          spokes           spokes

Building Topic Clusters

Step 1: Identify 3-7 core topics for your site (these become your silos)

Step 2: For each topic, create one pillar page (the hub) that covers the topic broadly

Step 3: Create spoke content for each major sub-question or sub-topic

Step 4: Implement linking:

• Hub links DOWN to every spoke
• Every spoke links UP to the hub (with keyword-rich anchor text)
• Spokes link ACROSS to related spokes within the same silo
• Cross-silo links are fine when contextually genuine

Step 5: Build the content before building the links. Links to non-existent content are useless.

Silo Depth Guidelines

Internal Linking Strategy

Link Equity Power Stack

Not all internal links carry equal weight. From most to least powerful:

Anchor Text Strategy

Orphan Page Detection and Resolution

An orphan page is indexed in Google but has zero inbound internal links. It is invisible to the site's link graph.

Detection method:

1. Export all indexed URLs (GSC Coverage or site: query)
2. Export all internal link targets (crawl tool or link extraction)
3. Pages in set A but not set B are orphans

Resolution actions:

Internal Linking Audit Checklist

Crawl Equity Management

Homepage Equity Distribution

The homepage is your highest-equity page. Use it wisely.

Crawl Budget Allocation

Architecture Audit Framework

Audit Scorecard

Red Flag Indicators

Restructuring Playbook

When to Restructure

Restructuring Steps

1. Crawl current site -- Export all URLs, internal links, and rankings
2. Map current to new -- Create 1:1 URL redirect mapping
3. Build redirect rules -- 301 redirects for every changed URL
4. Chain existing redirects -- Update old redirects to point to final destination
5. Update internal links -- Point to new URLs (do not rely on redirects for internal links)
6. Update sitemap -- Reflect new URL structure
7. Monitor for 60 days -- Watch for crawl errors, ranking changes, traffic impact

Architecture Patterns by Site Type

SaaS Website

/                           Homepage
├── /features/              Features hub
│   ├── /features/analytics Analytics feature
│   └── /features/reporting Reporting feature
├── /solutions/             Solutions hub (by use case)
│   ├── /solutions/marketing Marketing use case
│   └── /solutions/sales    Sales use case
├── /integrations/          Integrations hub
│   ├── /integrations/slack Slack integration
│   └── /integrations/salesforce Salesforce integration
├── /pricing                Pricing page
├── /blog/                  Blog index
│   ├── /blog/seo-guide     Blog post
│   └── /blog/growth-tips   Blog post
├── /docs/                  Documentation
└── /about                  About page

E-commerce Site

/                           Homepage
├── /[category]/            Category page (with content)
│   ├── /[category]/[subcategory]/ Subcategory (with content)
│   │   └── /[category]/[subcategory]/[product] Product page
│   └── /[category]/[product]      Product (if no subcategory)
├── /brands/                Brand hub
│   └── /brands/[brand]     Brand page
├── /blog/                  Content hub
└── /sale/                  Promotions hub

Content/Media Site

/                           Homepage
├── /[topic]/               Topic hub (pillar content)
│   ├── /[topic]/[subtopic] Subtopic article
│   └── /[topic]/[guide]    In-depth guide
├── /authors/               Author hub
│   └── /authors/[name]     Author page
├── /tools/                 Free tools hub
│   └── /tools/[tool]       Individual tool
└── /newsletter             Newsletter signup

Common Mistakes

Output Artifacts

Related Skills

• seo-audit -- For comprehensive SEO audits where architecture is one of several problem areas. Use seo-audit for the full picture, site-architecture for deep structural work.
• schema-markup -- For adding BreadcrumbList and other structured data after architecture decisions are finalized.
• programmatic-seo -- For hub-and-spoke structures at scale when generating hundreds of template-based pages.
• content-creator -- For creating the pillar content that hub pages need to rank effectively.

Troubleshooting

Success Criteria

• Crawl depth: 95%+ of indexable pages reachable within 3 clicks from homepage
• Zero orphan pages: No indexed pages without at least 3 inbound internal links
• URL cleanliness: 100% of URLs follow the established pattern — lowercase, hyphenated, descriptive, consistent trailing slash policy
• Navigation coverage: All key revenue and pillar pages accessible via primary or secondary navigation
• Internal link density: Every content page has 3-5 outbound contextual internal links with descriptive anchor text
• Silo coherence: Each topic cluster has a defined hub page with bidirectional links to all spokes
• Breadcrumb coverage: BreadcrumbList schema present on 100% of non-homepage pages

Scope & Limitations

In scope:

• URL hierarchy design and restructuring
• Navigation architecture (primary, secondary, breadcrumb, footer, contextual, sidebar)
• Silo structure and topic cluster planning
• Internal linking strategy and optimization
• Crawl equity analysis and optimization
• Architecture audits with scored reports
• URL migration planning with redirect mapping

Out of scope:

• Content creation for hub pages (use Content Production)
• Schema markup implementation (use Schema Markup)
• Technical SEO beyond architecture (use SEO Audit)
• Visual design or UX design of navigation
• CMS development or template coding
• External link building

Known limitations:

• Crawl equity distribution is estimated — Google does not publish exact PageRank flow data
• Architecture changes on large sites (10K+ pages) require careful phased migration to avoid traffic loss
• Navigation testing (card sorts, tree tests) requires user research tools and participants
• Cross-silo linking recommendations are qualitative — no deterministic formula exists for optimal cross-linking density

Scripts

# Analyze sitemap for depth and structure issues
python scripts/sitemap_analyzer.py --file sitemap.xml --json

# Check URLs for redirect chains and patterns
python scripts/redirect_checker.py --file urls.txt --json

# Map internal link structure from a sitemap
python scripts/link_mapper.py --sitemap sitemap.xml --json