site-architecture

Start with a content inventory and business goals, then apply the 3-click rule so important pages sit within three clicks of the homepage. Group pages into a hierarchy of 2-4 levels depending on site type, and document it as an ASCII tree with URLs at each node.

Use short, readable, lowercase paths with hyphens that mirror the hierarchy, such as /blog/post-slug and /features/feature-name. Avoid dates, IDs, query parameters, and deep nesting, and keep one consistent pattern per section.

Keep the primary header navigation to 4-7 items, ordered by priority, with the CTA button rightmost. If a dropdown grows beyond roughly 20 items, add a hierarchy level or use a mega menu with 2-4 grouped columns.

No. XML sitemaps, crawl errors, and indexation are technical SEO concerns handled by the seo-audit skill. This skill covers information architecture design: page hierarchy, navigation, URL patterns, and internal linking.

Use Mermaid graph TD diagrams showing pages as nodes and hierarchy as edges, with subgraphs marking header and footer navigation zones. Color-coding can distinguish existing, new, and deprecated pages for restructuring proposals.

A hub page comprehensively covers a topic and links to detailed spoke pages, each of which links back to the hub and to related spokes. It concentrates internal link equity on the hub and ensures no spoke becomes an orphan page.