site-architecture

Plan website information architecture with ASCII trees and Mermaid sitemaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams plan and optimize a website's structure, navigation, URL patterns, and internal linking to improve usability and discoverability.

Core Features & Use Cases

  • Page hierarchy planning: Define a clear L0-L2 structure and scalable navigation for complex sites.
  • Navigation design guidance: Provide header, footer, sidebar, and breadcrumb patterns to ensure 3-click reachability.
  • URL pattern governance: Recommend human-readable, consistent URLs and align breadcrumbs with site structure.
  • Use Case: For a mid-size site undergoing a restructure, generate an ASCII hierarchy and Mermaid sitemap to communicate the plan to product, design, and engineering teams.

Quick Start

Draft a practical site-hierarchy plan for a new or restructuring website, including an ASCII tree and a Mermaid sitemap.

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 structure and navigation hierarchy?

Plan website structure by defining a clear L0-L2 page hierarchy and navigation patterns. This approach outlines page relationships, ensuring scalable navigation and 3-click reachability for complex sites.

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

Document a sitemap and internal linking strategy by generating an ASCII tree and a Mermaid sitemap. These deliverables map page hierarchy and URL patterns to communicate implementation plans to product and engineering teams.

How do I design URL patterns and breadcrumbs for a site restructure?

Design URL patterns and breadcrumbs by establishing human-readable, consistent URLs aligned with your site structure. This governance ensures breadcrumbs match the page hierarchy and improves overall site discoverability.

Can I use this information architecture approach for both new sites and restructures?

Yes, this information architecture approach applies to both new sites and restructures. It scales to mid-size sites undergoing changes, delivering a defined URL mapping and visual sitemap to guide the restructure.

What deliverables do I get when planning site architecture?

Deliverables for site architecture planning include an ASCII tree representing the page hierarchy, a Mermaid sitemap for visual mapping, and a defined URL mapping document to guide engineering implementation.

Why does my website navigation fail the 3-click reachability rule?

Website navigation fails the 3-click reachability rule when the page hierarchy lacks a clear L0-L2 structure. Correcting this requires planning header, footer, sidebar, and breadcrumb patterns to ensure proper internal linking.