Strategy: Website Structure
Guides website structure planning: which pages to build, page priority, and how structure supports UX, SEO, and growth. Structure is the organization and connection of pages; it affects user navigation, Google's understanding of content importance, crawlability, and sitelinks in SERPs. See serp-features for sitelinks and SERP optimization.
When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for product type, audience, and growth goals.
Identify:
- Website type: Product/SaaS, B2B, E-commerce, Portfolio, Forum, Directory
- Stage: New site (plan from scratch) vs. existing (extend or audit)
- Growth strategy: Affiliate, education, multi-language, community, B2B, developer
- Constraints: Team size, budget, tech stack
Page Priority Framework
Plan pages by priority for development scheduling. See skills-reference §2 Page Taxonomy for full page types and website-type mapping.
| Priority |
Pages |
Notes |
| Must Have |
Home, Product/Features, Pricing, Blog, About, Privacy, Terms, Contact |
Essential for trust and conversion; Pricing: public page in nav for self-serve; enterprise-only may use "Contact sales" instead; see pricing-page-generator (Visibility & Placement) |
| Great to Have |
Testimonials, FAQ, Sitemap (HTML), 404, Refund/Returns |
Support UX and SEO |
| Optional |
Search Results, News, Careers, Disclosure |
Situational |
| Traffic-driven |
Category/Collection pages |
For content-heavy or e-commerce; needs Category + Tags |
Generic Template Structure
Applicable to SaaS, tools, and content sites. Adapt by removing unused nodes (e.g. no API → drop API) and adding specific modules (e.g. industry, region).
| Section |
Typical Paths |
Page Skills |
| Root |
/, /features, /pricing, /demo, /contact |
homepage-generator, features-page-generator, pricing-page-generator |
| Tools |
/tools, /free-tools; hub + per-tool pages |
tools-page-generator; free tools for lead gen; often SPA; programmatic; see programmatic-seo |
| Resources |
/blog, /changelog, /glossary, /faq, /tutorials |
blog-page-generator, changelog-page-generator, glossary-page-generator, faq-page-generator |
| Partnership |
/affiliate, /startups, /ambassadors |
affiliate-page-generator, landing-page-generator |
| Legal |
/terms, /privacy, /careers |
terms-page-generator, privacy-page-generator, careers-page-generator |
| Competitor |
/alternatives, /compare, /migrate |
alternatives-page-generator, migration-page-generator |
| Standalone |
/dashboard, /login, /signup, /docs, /api, /status, /support |
signup-login-page-generator, docs-page-generator, api-page-generator, status-page-generator |
Growth Strategy → Structure Mapping
Structure reflects growth strategy. Subdirectories signal channels:
| Goal |
Path Example |
Page/Channel |
| Affiliate conversion |
/affiliate |
affiliate-page-generator |
| Education/student plan |
/education, /startups, /student-discount |
education-program, startups-page-generator |
| Multi-language |
/zh-CN, /ja |
localization-strategy |
| Community |
/ambassadors, /showcase |
creator-program, landing-page-generator |
| B2B / Enterprise |
Solutions (industry-first), Use cases (scenario-first; can be sub-pages), Customer stories |
solutions-page-generator, use-cases-page-generator, customer-stories-page-generator |
| Developer product |
/api, /docs, /status |
api-page-generator, docs-page-generator, status-page-generator |
| User feedback |
Feedback, Roadmap |
feedback-page-generator; External (Canny, FeatureBase) |
| Plugins/Integrations |
/integrations, /plugins |
integrations-page-generator, category-page-generator |
| Giveaway/Contest |
/giveaway |
contest-page-generator |
Domain Structure (Multiple Products)
When planning for multiple products or brands, see domain-architecture for subfolder vs subdomain vs independent domain. This skill covers page structure within a single domain. For initial domain choice (Brand vs PMD vs EMD, TLD), see domain-selection.
Planning Workflow
- Choose template: Start from generic structure; map to skills-reference §2 website types
- Trim modules: Remove irrelevant nodes (e.g. no API → drop /api, /docs)
- Add specifics: Industry pages, region, product variants
- Assign URLs: Per node; follow url-structure (lowercase, hyphens, short, keyword-rich)
- Export list: "Page type + URL + Priority" for dev scheduling
- Tech stack: Match page types to services (DNS, auth, CMS, status page, etc.)
- Iterate: Expand with new features, markets; keep structure clear
Structure Principles
| Principle |
Guideline |
| Flat structure |
Max 4 clicks from homepage to any page; improves crawlability and weight distribution |
| Early planning |
Plan structure before growth; can start right after domain purchase |
| Sitelinks |
Good structure + TOC + authoritative internal links → natural sitelinks in SERP (cannot be forced via schema); see serp-features |
| Orphan prevention |
Every page needs internal links; see site-crawlability and internal-links |
| Features vs Use cases |
/features = capability-first; /use-cases = scenario-first; differentiate content angle, link between, avoid overlap; see features-page-generator, use-cases-page-generator |
| Clear navigation |
Clear hierarchy and nav improve task completion; users find what they need faster; see navigation-menu-generator |
| Pricing placement |
Marketing site: /pricing in main nav for prospects; in-app: Settings → Billing in sidebar for logged-in users (subscription management). Enterprise-only: "Contact sales" may replace public pricing page; see pricing-page-generator |
Homepage Module Reference
See homepage-generator for common modules (Headline, Subheadline, CTA, Benefits, Social Proof, etc.), navigation options, and hero-generator for hero design.
Output Format
- Page list with priority (Must Have / Great to Have / Optional)
- URL structure (paths per section)
- Website-type fit (which pages apply per skills-reference §2)
- Growth mapping (which paths support which channels)
- Next steps: url-structure for URL rules; xml-sitemap for submission; site-crawlability for audit
References
- Website structure SEO guide — Alignify: structure importance, page priority, generic template, planning workflow, growth mapping, homepage modules
- skills-reference §2 (docs/skills-reference.md#2-page-taxonomy) — Full page types, website-type matrix, core vs extended; use for page selection
Related Skills
- seo-strategy: SEO workflow order; structure planning fits before Technical phase
- domain-selection: Initial domain choice; do before structure when choosing domain
- domain-architecture: Subfolder vs subdomain vs independent; do before structure if domain decision pending
- url-structure: URL optimization, hierarchy, slugs; apply after structure is defined
- site-crawlability: Crawlability, orphan pages, redirects; audit existing structure
- internal-links: Link strategy, hub-spoke; implement after pages exist
- xml-sitemap: Sitemap creation; include planned URLs
- breadcrumb-generator: Breadcrumb for hierarchy; large sites, e-commerce
- navigation-menu-generator: Nav design; primary, footer, mobile
- content-strategy: Content clusters, pillar pages; complements structure planning
1---2name: website-structure3description: When the user wants to plan website structure, decide which pages to build, or prioritize pages for a new or existing site. Also use when the user mentions "website structure," "site structure," "which pages do I need," "page planning," "sitemap planning," "Must Have pages," "website architecture," or "site hierarchy." For a specific page template (e.g. homepage), use homepage-generator or landing-page-generator as appropriate. Not for organic SEO roadmap alone; use seo-strategy.4---5
6# Strategy: Website Structure
7
8Guides website structure planning: which pages to build, page priority, and how structure supports UX, SEO, and growth. Structure is the organization and connection of pages; it affects user navigation, Google's understanding of content importance, crawlability, and sitelinks in SERPs. See **serp-features** for sitelinks and SERP optimization.
9
10**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
11
12## Initial Assessment
13
14**Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for product type, audience, and growth goals.
15
16Identify:
171. **Website type**: Product/SaaS, B2B, E-commerce, Portfolio, Forum, Directory
182. **Stage**: New site (plan from scratch) vs. existing (extend or audit)
193. **Growth strategy**: Affiliate, education, multi-language, community, B2B, developer
204. **Constraints**: Team size, budget, tech stack
21
22## Page Priority Framework
23
24Plan pages by priority for development scheduling. See [skills-reference §2 Page Taxonomy](../../../docs/skills-reference.md#2-page-taxonomy) for full page types and website-type mapping.
25
26| Priority | Pages | Notes |
27|----------|-------|-------|
28| **Must Have** | Home, Product/Features, Pricing, Blog, About, Privacy, Terms, Contact | Essential for trust and conversion; Pricing: public page in nav for self-serve; enterprise-only may use "Contact sales" instead; see **pricing-page-generator** (Visibility & Placement) |
29| **Great to Have** | Testimonials, FAQ, Sitemap (HTML), 404, Refund/Returns | Support UX and SEO |
30| **Optional** | Search Results, News, Careers, Disclosure | Situational |
31| **Traffic-driven** | Category/Collection pages | For content-heavy or e-commerce; needs Category + Tags |
32
33## Generic Template Structure
34
35Applicable to SaaS, tools, and content sites. Adapt by removing unused nodes (e.g. no API → drop API) and adding specific modules (e.g. industry, region).
36
37| Section | Typical Paths | Page Skills |
38|---------|---------------|-------------|
39| **Root** | /, /features, /pricing, /demo, /contact | homepage-generator, features-page-generator, pricing-page-generator |
40| **Tools** | /tools, /free-tools; hub + per-tool pages | tools-page-generator; free tools for lead gen; often SPA; programmatic; see **programmatic-seo** |
41| **Resources** | /blog, /changelog, /glossary, /faq, /tutorials | blog-page-generator, changelog-page-generator, glossary-page-generator, faq-page-generator |
42| **Partnership** | /affiliate, /startups, /ambassadors | affiliate-page-generator, landing-page-generator |
43| **Legal** | /terms, /privacy, /careers | terms-page-generator, privacy-page-generator, careers-page-generator |
44| **Competitor** | /alternatives, /compare, /migrate | alternatives-page-generator, migration-page-generator |
45| **Standalone** | /dashboard, /login, /signup, /docs, /api, /status, /support | signup-login-page-generator, docs-page-generator, api-page-generator, status-page-generator |
46
47## Growth Strategy → Structure Mapping
48
49Structure reflects growth strategy. Subdirectories signal channels:
50
51| Goal | Path Example | Page/Channel |
52|------|--------------|--------------|
53| Affiliate conversion | /affiliate | affiliate-page-generator |
54| Education/student plan | /education, /startups, /student-discount | education-program, startups-page-generator |
55| Multi-language | /zh-CN, /ja | localization-strategy |
56| Community | /ambassadors, /showcase | creator-program, landing-page-generator |
57| B2B / Enterprise | Solutions (industry-first), Use cases (scenario-first; can be sub-pages), Customer stories | solutions-page-generator, use-cases-page-generator, customer-stories-page-generator |
58| Developer product | /api, /docs, /status | api-page-generator, docs-page-generator, status-page-generator |
59| User feedback | Feedback, Roadmap | feedback-page-generator; External (Canny, FeatureBase) |
60| Plugins/Integrations | /integrations, /plugins | integrations-page-generator, category-page-generator |
61| Giveaway/Contest | /giveaway | contest-page-generator |
62
63## Domain Structure (Multiple Products)
64
65When planning for multiple products or brands, see **domain-architecture** for subfolder vs subdomain vs independent domain. This skill covers page structure within a single domain. For initial domain choice (Brand vs PMD vs EMD, TLD), see **domain-selection**.
66
67## Planning Workflow
68
691. **Choose template**: Start from generic structure; map to [skills-reference §2](../../../docs/skills-reference.md#2-page-taxonomy) website types
702. **Trim modules**: Remove irrelevant nodes (e.g. no API → drop /api, /docs)
713. **Add specifics**: Industry pages, region, product variants
724. **Assign URLs**: Per node; follow **url-structure** (lowercase, hyphens, short, keyword-rich)
735. **Export list**: "Page type + URL + Priority" for dev scheduling
746. **Tech stack**: Match page types to services (DNS, auth, CMS, status page, etc.)
757. **Iterate**: Expand with new features, markets; keep structure clear
76
77## Structure Principles
78
79| Principle | Guideline |
80|-----------|-----------|
81| **Flat structure** | Max 4 clicks from homepage to any page; improves crawlability and weight distribution |
82| **Early planning** | Plan structure before growth; can start right after domain purchase |
83| **Sitelinks** | Good structure + TOC + authoritative internal links → natural sitelinks in SERP (cannot be forced via schema); see **serp-features** |
84| **Orphan prevention** | Every page needs internal links; see **site-crawlability** and **internal-links** |
85| **Features vs Use cases** | /features = capability-first; /use-cases = scenario-first; differentiate content angle, link between, avoid overlap; see **features-page-generator**, **use-cases-page-generator** |
86| **Clear navigation** | Clear hierarchy and nav improve task completion; users find what they need faster; see **navigation-menu-generator** |
87| **Pricing placement** | Marketing site: /pricing in main nav for prospects; in-app: Settings → Billing in sidebar for logged-in users (subscription management). Enterprise-only: "Contact sales" may replace public pricing page; see **pricing-page-generator** |
88
89## Homepage Module Reference
90
91See **homepage-generator** for common modules (Headline, Subheadline, CTA, Benefits, Social Proof, etc.), navigation options, and **hero-generator** for hero design.
92
93## Output Format
94
95- **Page list** with priority (Must Have / Great to Have / Optional)
96- **URL structure** (paths per section)
97- **Website-type fit** (which pages apply per [skills-reference §2](../../../docs/skills-reference.md#2-page-taxonomy))
98- **Growth mapping** (which paths support which channels)
99- **Next steps**: url-structure for URL rules; xml-sitemap for submission; site-crawlability for audit
100
101## References
102
103- [Website structure SEO guide](https://alignify.co/zh/seo/website-structure) — Alignify: structure importance, page priority, generic template, planning workflow, growth mapping, homepage modules
104- **skills-reference §2** (docs/skills-reference.md#2-page-taxonomy) — Full page types, website-type matrix, core vs extended; use for page selection
105
106## Related Skills
107
108- **seo-strategy**: SEO workflow order; structure planning fits before Technical phase
109- **domain-selection**: Initial domain choice; do before structure when choosing domain
110- **domain-architecture**: Subfolder vs subdomain vs independent; do before structure if domain decision pending
111- **url-structure**: URL optimization, hierarchy, slugs; apply after structure is defined
112- **site-crawlability**: Crawlability, orphan pages, redirects; audit existing structure
113- **internal-links**: Link strategy, hub-spoke; implement after pages exist
114- **xml-sitemap**: Sitemap creation; include planned URLs
115- **breadcrumb-generator**: Breadcrumb for hierarchy; large sites, e-commerce
116- **navigation-menu-generator**: Nav design; primary, footer, mobile
117- **content-strategy**: Content clusters, pillar pages; complements structure planning
gabrielmoreira