site-architecture

Plan website hierarchies, navigation, URLs, and internal linking with ASCII and Mermaid outputs.

2|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/successunforgettable/coachflow --skill site-architecture-successunforgettable
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/successunforgettable/coachflow/tree/main/.agents/skills/site-architecture
Command: npx skills add https://github.com/successunforgettable/coachflow --skill site-architecture-successunforgettable

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps teams design or restructure a website's page hierarchy, navigation, URL patterns, and internal linking so users can find important pages quickly and search engines can crawl and rank the site effectively. It reduces confusion from ad-hoc growth, prevents orphaned pages, and ensures navigation and URLs reflect business priorities and SEO best practices.

Core Features & Use Cases

  • Context-aware planning: checks for existing product-marketing-context before asking redundant questions and uses that input to shape the architecture.
  • Structured deliverables: produces ASCII page hierarchies, Mermaid visual sitemaps, URL maps, navigation specifications (header, footer, sidebar), and internal linking plans including hub-and-spoke recommendations.
  • Site-type templates & patterns: provides starting points for SaaS, content/blog, e-commerce, docs, hybrid, and small-business sites and advises on crawl budget, redirects, and programmatic SEO sections.
  • Use case: reorganizing a 50+ page marketing site into a 3-level hierarchy with reduced header items, clear CTA placement, and a redirect plan to preserve SEO equity.

Quick Start

Ask the assistant to create a complete site architecture plan for my [site type] that includes an ASCII hierarchy, a Mermaid sitemap, a URL map, a header/footer/nav spec, and an internal linking plan while referencing any existing product-marketing-context file.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
How do I plan a website page hierarchy and URL structure for SEO?

You can plan website page hierarchy and URL structure by generating ASCII page trees, Mermaid visual sitemaps, and URL maps. This ensures intuitive user journeys and SEO-friendly internal linking across SaaS, e-commerce, or documentation sites.

What is the best way to visualize a sitemap and internal linking strategy?

The best way to visualize a sitemap and internal linking strategy is creating Mermaid visual sitemaps alongside ASCII hierarchies. This approach clarifies hub-and-spoke connections and prevents orphaned pages during site architecture planning.

How do I restructure an existing marketing site without losing SEO equity?

Restructure an existing marketing site without losing SEO equity by mapping a new 3-level hierarchy and generating a redirect plan. This preserves crawl equity while consolidating navigation and improving internal linking across pages.

Can I use this approach for programmatic SEO sections like integrations and comparisons?

Yes, you can use this site architecture approach for programmatic SEO sections like integrations and comparisons. It provides starting templates for hybrid and SaaS sites while advising on crawl budget and URL patterns for scaled content.

What do I need to design site navigation and URL patterns for a new SaaS site?

To design site navigation and URL patterns for a new SaaS site, you need to define your business priorities and product context. The planning process then outputs header, footer, and sidebar navigation specifications tailored to your content.

Why does my website have orphaned pages and poor crawl budget?

Websites develop orphaned pages and poor crawl budget from ad-hoc growth without a unified site architecture. Solving this requires mapping a clear page hierarchy and implementing an internal linking plan to connect all content nodes.