site-architecture
Site architecture
Architecture is what pages exist, how they nest, what their URLs are, and how they link: settle it before the platform, because the platform has to carry the plan, not the other way round [coreyhaines31/marketingskills, site-architecture]. This skill is coreyhaines31/marketingskills' site-architecture v2.1.0 (MIT, "Copyright (c) 2025 Corey Haines"), copied where quoted, with each rule checked against Google Search Central and the WAI-ARIA Authoring Practices; where they differ, the official form is written and the source's line is named.
XML sitemaps, crawl errors and technical SEO are in seo SKILL.md (the source routes them out the same way); pages built at scale from data are in seo PAGES-AT-SCALE.md; breadcrumb and other structured data in seo STRUCTURED-DATA.md; comparison pages in comparison-pages SKILL.md; what content to plan in content-strategy SKILL.md; auditing a live site in site-audit SKILL.md. The house pattern for the owner's own marketing sites (header, footer, language prefixes, routes) is landing-page-ui SKILL.md; where this generic skill disagrees, both are stated and the house pattern wins on those sites.
Apply only the routes and checks for the selected job. Read a linked skill's named file from its installed folder when available, or from the linked source. Report an unavailable required reference instead of inventing it. [skill-authoring, DISTRIBUTION.md#composing-skills]
| The job | Read |
|---|---|
| URL principles (case, hyphens, slashes), patterns by page type, common URL mistakes, breadcrumbs and what Google says about them, internal link types, hub and spoke, the link audit checklist | URLS-AND-LINKS.md |
| Header, mega menu and split navigation, footers, docs and blog sidebars, breadcrumb markup, mobile menus and bottom tabs, navigation anti-patterns, crawlable links | NAVIGATION.md |
| Choosing a platform (six questions, the options), adding a section (same platform, reverse-proxied subpath, subdomain, separate domain), the reverse-proxy checklist, migrating without losing traffic | PLATFORMS-AND-MIGRATION.md |
| The ASCII page tree, Mermaid sitemaps (basic, nav zones, URL labels, hub and spoke, linking flow, before and after) and the colour key | SITEMAP-DIAGRAMS.md |
| Starting page trees, URL maps and navigation for SaaS, content, e-commerce, docs, hybrid and small-business sites | SITE-TYPES.md |
Before planning
Read the project's product context first: .agents/product-context.md (anti-slop-copy CONTEXT.md; the source names this file .agents/product-marketing.md). Ask only for what it does not cover. Gather [coreyhaines31/marketingskills, site-architecture]: