site-architecture

# Site Architecture Designs the whole-site information architecture — page hierarchy, navigation, URL taxonomy, hub/spoke topic clusters, and link topology — then outputs Mermaid site maps that make orphans and link islands visible. Scope vs `internal-linking-optimizer`: that skill optimizes the links on and between pages that already exist; this skill designs the structure those pages and links live in. Use it first when the layout itself is the question. ## Quick Start Start with one of these prompts, then finish with the standard handoff summary from [Skill Contract](../../references/skill-contract.md). ```text Plan the site structure for a new SaaS marketing site Restructure my existing site — pages feel buried and disorganized Design the URL taxonomy and navigation for [domain] Map hub/spoke topic clusters for my blog around [topic] Draw a visual sitemap that shows orphan pages and link islands What pages do I need and how should they connect? ``` ## Skill Contract **Expected output**: a page hierarchy (ASCII tree), a URL map table, a navigation spec, a hub/spoke link plan, a Mermaid site map flagging orphans/islands, an **architecture score /100**, and a short handoff summary ready for `memory/audits/`. - **Reads**: site type, goals, page inventory or sitemap, key pages, audiences, and existing URLs to preserve. - **Writes**: a user-facing architecture plan plus a reusable summary that can be stored under `memory/audits/`. - **Promotes**: blocking defects (e.g. ...