site-architecture

Plan site hierarchies with L0-L3 levels, URL patterns, and hub-and-spoke linking.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sachio222/based-stack --skill site-architecture-sachio222
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/sachio222/based-stack/tree/main/site-architecture
Command: npx skills add https://github.com/sachio222/based-stack --skill site-architecture-sachio222

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning and reorganizing a website's structure, navigation, and URL patterns to improve usability, findability, and scalability across pages and sections.

Core Features & Use Cases

  • Define a clear page hierarchy (L0-L3) and consistent URL structure to support scalable growth.
  • Produce ASCII trees or Mermaid diagrams to communicate architecture to design and engineering teams.
  • Develop an internal linking strategy (hub-and-spoke) and breadcrumb guidelines to boost discoverability and SEO.

Quick Start

Create an initial site map for a typical SaaS site and export an ASCII tree and a Mermaid diagram for review.

Frequently Asked Questions about site-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to plan a scalable site architecture for a SaaS or marketing site?

Planning scalable site architecture involves defining a clear page hierarchy from L0 to L3 and establishing consistent URL patterns to support growth. This approach optimizes navigation and findability across pages for SaaS, marketing, docs, and content-heavy sites.

How do I create a visual sitemap using Mermaid diagrams or ASCII trees?

You can create visual sitemaps by generating ASCII trees or Mermaid diagrams to communicate site architecture. These visual outputs map page hierarchies and navigation structures, making it easier for design and engineering teams to review and implement.

How do I design an internal linking strategy using a hub-and-spoke model?

Designing an internal linking strategy with a hub-and-spoke model connects central pillar pages to related sub-pages, boosting discoverability and SEO. Defining breadcrumb guidelines alongside this structure further improves findability across content sections.

Can I use this site architecture planning approach for documentation and content-heavy sites?

Yes, this site architecture planning approach applies directly to documentation and content-heavy sites. It defines hierarchical levels, URL patterns, and navigation specs to optimize findability and scalability across complex content structures.

What URL structure patterns should I define when organizing site hierarchy levels?

When organizing site hierarchy levels L0 through L3, you should define consistent URL structure patterns that reflect the page hierarchy. This ensures URLs scale logically as the site grows and supports both navigation specs and internal linking models.