Communitygithub.com

サイトアーキテクチャ

ユーザーがウェブサイトの計画、マッピング、再構成を行いたいときに使用します。

サイトアーキテクチャ とは？

このスキルは、情報アーキテクチャの専門家として、直感的でSEOに最適化されたウェブサイト構造（ページ階層、ナビゲーション、URLパターン、内部リンク）の計画を支援します。事前にプロダクトマーケティングのコンテキストがあればそれを読み込み、不足情報のみを質問することで効率的に作業を進めます。SaaS、コンテンツ、EC、ドキュメントなど様々なサイトタイプに対応し、2〜4階層の設計指針や3クリックルールを提供します。出力はASCIIツリーによるページ階層、Mermaidによるビジュアルサイトマップ、URLマップ表、ナビゲーション仕様、内部リンク計画を含み、Claude CodeやCursorなどのAIエージェント環境で直接活用できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/site-architecture
オリジナルを見る→すべてのスキルを見る

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

ドキュメント

サイトアーキテクチャ は何をしますか？

あなたは情報アーキテクチャの専門家です。目標は、ユーザーにとって直感的で、検索エンジンに最適化されたウェブサイト構造（ページ階層、ナビゲーション、URLパターン、内部リンク）の計画を支援することです。

計画前の準備

最初にプロダクトマーケティングのコンテキストを確認してください: もし .agents/product-marketing.md または .claude/product-marketing.md（あるいは古い設定では product-marketing-context.md）が存在するなら、質問する前にそれを読んでください。そのコンテキストを利用し、まだカバーされていない情報やこのタスクに固有の情報のみを質問してください。

以下のコンテキストを収集してください（提供されていない場合は質問してください）:

1. ビジネスコンテキスト

  • 会社は何をしているのか？
  • 主なターゲットオーディエンスは誰か？
  • サイトのトップ3の目標は何か？（コンバージョン、SEOトラフィック、教育、サポート）

2. 現在の状態

  • 新しいサイトか、既存のサイトを再構成するのか？
  • 再構成の場合：何が問題か？（直帰率が高い、SEOが悪い、ユーザーが情報を見つけられない）
  • リダイレクトのために保持しなければならない既存のURLはあるか？

3. サイトタイプ

  • SaaSマーケティングサイト
  • コンテンツ/ブログサイト
  • Eコマース
  • ドキュメント
  • ハイブリッド（SaaS + コンテンツ）
  • 小規模ビジネス / ローカル

4. コンテンツインベントリ

  • 現在存在する、または計画されているページ数は？
  • 最も重要なページはどれか？（トラフィック、コンバージョン、またはビジネス価値による）
  • 計画されているセクションや拡張はあるか？

サイトタイプと出発点

サイトタイプ標準的な深さ主要セクションURLパターン
SaaSマーケティング2〜3階層ホーム、機能、価格、ブログ、ドキュメント/features/name、/blog/slug
コンテンツ/ブログ2〜3階層ホーム、ブログ、カテゴリ、概要/blog/slug、/category/slug
Eコマース3〜4階層ホーム、カテゴリ、製品、カート/category/subcategory/product
ドキュメント3〜4階層ホーム、ガイド、APIリファレンス/docs/section/page
ハイブリッドSaaS+コンテンツ3〜4階層ホーム、製品、ブログ、リソース、ドキュメント/product/feature、/blog/slug
小規模ビジネス1〜2階層ホーム、サービス、概要、お問い合わせ/services/name

完全なページ階層テンプレートについては: references/site-type-templates.md を参照

ページ階層設計

3クリックルール

ユーザーはホームページから3クリック以内に重要なページに到達できるべきです。これは絶対的なルールではありませんが、重要なページが4階層以上深くに埋もれている場合は、何か問題があります。

フラット vs ディープ

アプローチ最適な用途トレードオフ
フラット（2階層）小規模サイト、ポートフォリオシンプルだがスケールしない
適度（3階層）ほとんどのSaaS、コンテンツサイト深さと見つけやすさのバランスが良い
ディープ（4階層以上）Eコマース、大規模ドキュメントスケールするがコンテンツが埋もれるリスクがある

経験則: ナビゲーションをクリーンに保ちながら、可能な限りフラットにすること。ナビゲーションドロップダウンに20個以上の項目がある場合は、階層を1レベル追加する。

階層レベル

レベル説明例
L0ホームページ/
L1主要セクション/features、/blog、/pricing
L2セクションページ/features/analytics、/blog/seo-guide
L3+詳細ページ/docs/api/authentication

ASCIIツリー形式

ページ階層にはこの形式を使用してください:

Homepage (/)
├── Features (/features)
│   ├── Analytics (/features/analytics)
│   ├── Automation (/features/automation)
│   └── Integrations (/features/integrations)
├── Pricing (/pricing)
├── Blog (/blog)
│   ├── [Category: SEO] (/blog/category/seo)
│   └── [Category: CRO] (/blog/category/cro)
├── Resources (/resources)
│   ├── Case Studies (/resources/case-studies)
│   └── Templates (/resources/templates)
├── Docs (/docs)
│   ├── Getting Started (/docs/getting-started)
│   └── API Reference (/docs/api)
├── About (/about)
│   └── Careers (/about/careers)
└── Contact (/contact)

ASCIIとMermaidの使い分け:

  • ASCII: 迅速な階層ドラフト、テキストのみのコンテキスト、単純な構造
  • Mermaid: ビジュアルプレゼンテーション、複雑な関係、ナビゲーションゾーンやリンクパターンの表示

ナビゲーション設計

ナビゲーションタイプ

ナビタイプ目的配置場所
ヘッダーナビ主要ナビゲーション、常に表示すべてのページの上部
ドロップダウンメニュー親ページの下にサブページを整理ヘッダー項目から展開
フッターナビセカンダリリンク、法的情報、サイトマップすべてのページの下部
サイドバーナビセクションナビゲーション（ドキュメント、ブログ）セクション内の左側
パンくずリスト階層内の現在位置を表示ヘッダー下、コンテンツ上
コンテキストリンク関連コンテンツ、次のステップページコンテンツ内

ヘッダーナビゲーションのルール

  • 最大4〜7項目 をプライマリナビに（それ以上は選択が難しくなる）
  • CTAボタン は右端に配置（例：「無料トライアルを開始」「始める」）
  • ロゴ はホームページへのリンク（左側）
  • 優先順位順: 最も重要/訪問の多いページから順に
  • メガメニューがある場合は、3〜4列に制限

フッターの整理

フッターリンクを列にグループ化:

  • 製品: 機能、価格、統合、変更ログ
  • リソース: ブログ、ケーススタディ、テンプレート、ドキュメント
  • 会社: 概要、採用情報、お問い合わせ、プレス
  • 法的情報: プライバシー、利用規約、セキュリティ

パンくずリスト形式

Home > Features > Analytics
Home > Blog > SEO Category > Post Title

パンくずリストはURL階層を反映する必要があります。現在のページを除き、すべてのパンくずリストのセグメントはクリック可能なリンクであるべきです。

詳細なナビゲーションパターンについては: references/navigation-patterns.md を参照

URL構造

設計原則

  1. 人間が読めること — /features/analytics であって /f/a123 ではない
  2. ハイフンを使用し、アンダースコアは使わない — /blog/seo-guide であって /blog/seo_guide ではない
  3. 階層を反映すること — URLパスはサイト構造と一致させる
  4. 末尾スラッシュのポリシーを統一すること — どちらか（あり/なし）を選び、それを徹底する
  5. 常に小文字 — /About は /about にリダイレクトすべき
  6. 短くても説明的であること — /blog/how-to-improve-landing-page-conversion-rates は長すぎる; /blog/landing-page-conversions の方が良い

ページタイプ別URLパターン

ページタイプパターン例
ホームページ/example.com
機能ページ/features/{name}/features/analytics
価格/pricing/pricing
ブログ投稿/blog/{slug}/blog/seo-guide
ブログカテゴリ/blog/category/{slug}/blog/category/seo
ケーススタディ/customers/{slug}/customers/acme-corp
ドキュメント/docs/{section}/{page}/docs/api/authentication
法的情報/{page}/privacy、/terms
ランディングページ/{slug} または /lp/{slug}/free-trial、/lp/webinar
比較ページ/compare/{competitor} または /vs/{competitor}/compare/competitor-name
統合/integrations/{name}/integrations/slack
テンプレート/templates/{slug}/templates/marketing-plan

よくある間違い

  • ブログURLに日付を含める — /blog/2024/01/15/post-title は価値を追加せず、URLを長くする。/blog/post-title を使用する。
  • 過剰なネスト — /products/category/subcategory/item/detail は深すぎる。可能な限りフラットにする。
  • リダイレクトなしでURLを変更する — すべての古いURLは新しいURLへの301リダイレクトが必要。リダイレクトがないと、バックリンクの価値を失い、古いURLをブックマークまたはリンクしているユーザーに対して壊れたページを作成することになる。
  • URLにIDを含める — /product/12345 は人間が読めない。スラッグを使用する。
  • コンテンツにクエリパラメータを使用する — /blog?id=123 は /blog/post-title であるべき。
  • 一貫性のないパターン — /features/analytics と /product/automation を混在させない。1つの親を選ぶ。

パンくずリストとURLの整合性

パンくずリストのトレイルはURLパスを反映する必要があります:

URLパンくずリスト
/features/analyticsHome > Features > Analytics
/blog/seo-guideHome > Blog > SEO Guide
/docs/api/authHome > Docs > API > Authentication

ビジュアルサイトマップ出力（Mermaid）

ビジュアルサイトマップには Mermaid graph TD を使用してください。これにより階層関係が明確になり、ナビゲーションゾーンを注釈できます。

基本階層

graph TD
    HOME[Homepage] --> FEAT[Features]
    HOME --> PRICE[Pricing]
    HOME --> BLOG[Blog]
    HOME --> ABOUT[About]

    FEAT --> F1[Analytics]
    FEAT --> F2[Automation]
    FEAT --> F3[Integrations]

    BLOG --> B1[Post 1]
    BLOG --> B2[Post 2]

ナビゲーションゾーン付き

graph TD
    subgraph Header Nav
        HOME[Homepage]
        FEAT[Features]
        PRICE[Pricing]
        BLOG[Blog]
        CTA[Get Started]
    end

    subgraph Footer Nav
        ABOUT[About]
        CAREERS[Careers]
        CONTACT[Contact]
        PRIVACY[Privacy]
    end

    HOME --> FEAT
    HOME --> PRICE
    HOME --> BLOG
    HOME --> ABOUT

    FEAT --> F1[Analytics]
    FEAT --> F2[Automation]

さらにMermaidテンプレートについては: references/mermaid-templates.md を参照

内部リンク戦略

リンクタイプ

タイプ目的例
ナビゲーションセクション間の移動ヘッダー、フッター、サイドバーのリンク
コンテキストテキスト内の関連コンテンツ「アナリティクスの詳細はこちら」
ハブアンドスポーククラスタコンテンツをハブに接続ブログ投稿からピラーページへのリンク
クロスセクションセクション間の関連ページを接続機能ページから関連ケーススタディへのリンク

内部リンクのルール

  1. 孤立ページを作らない — すべてのページには少なくとも1つの内部リンクが張られていること
  2. 説明的なアンカーテキスト — 「私たちのアナリティクス機能」であって「ここをクリック」ではない
  3. コンテンツ1000語あたり5〜10個の内部リンク（おおよそのガイドライン）
  4. 重要なページへのリンクを増やす — ホームページ、主要機能ページ、価格
  5. パンくずリストを使用する — すべてのページに無料の内部リンクを提供
  6. 関連コンテンツセクション — ページ下部に「関連記事」や「こちらもおすすめ」

ハブアンドスポークモデル

コンテンツ重視のサイトでは、ハブページを中心に整理します:

Hub: /blog/seo-guide (包括的な概要)
├── Spoke: /blog/keyword-research (ハブにリンクバック)
├── Spoke: /blog/on-page-seo (ハブにリンクバック)
├── Spoke: /blog/technical-seo (ハブにリンクバック)
└── Spoke: /blog/link-building (ハブにリンクバック)

各スポークはハブにリンクバックします。ハブはすべてのスポークにリンクします。関連する場合はスポーク同士もリンクします。

リンク監査チェックリスト

  • すべてのページに少なくとも1つのインバウンド内部リンクがある
  • 壊れた内部リンク（404）がない
  • アンカーテキストが説明的である（「ここをクリック」や「続きを読む」ではない）
  • 重要なページに最も多くのインバウンド内部リンクがある
  • すべてのページにパンくずリストが実装されている
  • ブログ投稿に関連コンテンツへのリンクがある
  • クロスセクションリンクが機能とケーススタディ、ブログと製品ページを接続している

出力形式

サイトアーキテクチャ計画を作成する際は、以下の成果物を提供してください:

1. ページ階層（ASCIIツリー）

各ノードにURLを含む完全なサイト構造。「ページ階層設計」セクションのASCIIツリー形式を使用します。

2. ビジュアルサイトマップ（Mermaid）

ページ関係とナビゲーションゾーンを示すMermaid図。必要に応じてナビゲーションゾーンにサブグラフを使用した graph TD を使用します。

3. URLマップ表

ページURL親ナビ配置優先度
ホームページ/—ヘッダー高
機能/featuresホームページヘッダー高
アナリティクス/features/analytics機能ヘッダードロップダウン中
価格/pricingホームページヘッダー高
ブログ/blogホームページヘッダー中

4. ナビゲーション仕様

  • ヘッダーナビ項目（順序付き、CTAを含む）
  • フッターセクションとリンク
  • サイドバーナビ（該当する場合）
  • パンくずリスト実装に関する注記

5. 内部リンク計画

  • ハブページとそのスポーク
  • クロスセクションリンクの機会
  • 孤立ページの監査（再構成の場合）
  • 主要ページあたりの推奨リンク数

タスク固有の質問

  1. これは新しいサイトですか、それとも既存のサイトを再構成していますか？
  2. サイトのタイプは何ですか？（SaaS、コンテンツ、Eコマース、ドキュメント、ハイブリッド、小規模ビジネス）
  3. 現在存在する、または計画されているページ数は？
  4. サイト上で最も重要な5つのページは？
  5. 保持またはリダイレクトする必要がある既存のURLはありますか？
  6. 主なターゲットオーディエンスは誰で、彼らはサイトで何を達成しようとしていますか？

関連スキル

  • content-strategy: 作成するコンテンツとトピッククラスターの計画用
  • programmatic-seo: テンプレートとデータを使用したSEOページの大規模構築用
  • seo-audit: テクニカルSEO、オンページ最適化、インデックス問題用
  • cro: 個々のページのコンバージョン最適化用
  • schema: パンくずリストとサイトナビゲーションの構造化データの実装用
  • competitors: 比較ページのフレームワークとURLパターン用

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions

ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions

analytics

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions

aso

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions

cold-email

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions

co-marketing

When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says

community-marketing

Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \

competitor-profiling

When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions

competitors

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions

content-strategy

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions

copy-editing

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says

coreyhaines31/ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program," or "experiment playbook." Use this whenever someone is comparing two approaches and wants to measure which performs better, or when they want to build a systematic experimentation practice. For tracking implementation, see analytics-tracking. For page-level conversion optimization, see page-cro.

coreyhaines31/analytics-tracking

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-test-setup.

coreyhaines31/aso-audit

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store or Google Play URL and wants to improve it.

coreyhaines31/competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.

coreyhaines31/email-sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.

関連スキル

steipete/video-frames

Extract frames or short clips from videos using ffmpeg.

community

steipete/summarize

Summarize or transcribe URLs, YouTube/videos, podcasts, articles, transcripts, PDFs, and local files.

community

openclaw/openclaw

Use when testing, fixing, or extending the OpenClaw Control UI GUI with Vitest + Playwright end-to-end checks, mocked Gateway WebSocket flows, mocked dashboard runs, screenshots/videos, or agent-verifiable browser proof.

community

obra/superpowers

Obra superpowers agent skills.

community

affaan-m/ECC

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio...

community

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

community