Communitygithub.com

パンくずと経路案内システム

深い情報アーキテクチャにおいて、ユーザーに現在位置を示し、ワンクリックで親階層にアクセスできる二次ナビゲーショントレイルの設計と実装を体系的に行うためのフレームワークです。

パンくずと経路案内システム とは?

このスキルは、Webサイトやアプリケーションにおける「パンくずリスト」および経路案内システムの設計・実装を支援します。ユーザーが深い情報階層(IA)内で現在位置を把握し、ホームや親階層へ瞬時に戻れるようにするための、構造化された方法論を提供します。具体的には、eコマースのカテゴリ階層、ドキュメントサイトの章・節・ページ構成、SaaSダッシュボードのネストされたエンティティ管理など、複数階層を持つ情報構造で特に有効です。このシステムは、レスポンシブ対応(モバイルでの省略や「戻る」リンクへの置き換え)、アクセシビリティ(`<nav>`と`aria-label`を用いたセマンティックな実装)、および視覚的なノイズを抑えるデザインルールを重視します。コード実装はClaude Code、Coder、Cursorなど様々なAIエージェントプラットフォームで利用可能で、情報アーキテクチャマップ、現在のノード、親階層、表示制約を入力とし、経路案内図、トランケーション戦略、レスポンシブマッピング、アクセシビリティレイヤーを出力します。ワークフローは階層パスのマッピング、ビジュアルアナトミーの定義、スペーシングルールの適用、オーバーフロー処理、レスポンシブ適応の計画から成り、設計上の判断を支援する明確な決定ルールと、よくある失敗パターンの回避策も提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/breadcrumb-wayfinding-system

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

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

ドキュメント

パンくずと経路案内システム は何をしますか?

目的

パンくずと経路案内システムは、メインコンテンツの上に配置される二次ナビゲーショントレイルを設計するための方法論を提供します。これにより、ユーザーは深い情報アーキテクチャ(IA)の中で「迷子」になることがなくなり、現在の位置をホームページまたはルートディレクトリから見た明確な線形マップとして把握できます。このシステムは、ナビゲーションの正確さと視覚的な軽さのバランスを取り、ユーザーがコンテキストを理解し、ワンクリックで親階層に戻れることを保証します。

使用例

  • Eコマース: カテゴリ > サブカテゴリ > 商品 のナビゲーション
  • ドキュメント・Wiki: ボリューム > 章 > 節 > ページ の移動
  • SaaSダッシュボード: アカウント > プロジェクト > アセット のようなネストされたエンティティ管理
  • ディレクトリサイト: 地域 > カテゴリ > リスティング のブラウジング
  • 検索結果: 検索で見つかった特定のアイテムへのパスを表示

使用すべきでない場合

  • フラットなアーキテクチャ: サイトが1〜2階層(ホーム > ページ)しかない場合、パンくずは不要なノイズになります。
  • 直線的な進行: ステップ形式のウィザードやチェックアウトフローでは、代わりに step-progress-system を使用します。
  • 動的/非階層的なパス: ユーザーのパスが固定構造ではなくセッション履歴に基づく場合(例:「検索結果に戻る」)、代わりに「戻る」ボタンを使用します。
  • ランディングページ: 目標が単一のコンバージョンであり、ナビゲーションが主要なCTAから注意をそらす場合。

入力

  1. 情報アーキテクチャ (IA): サイトの階層構造マップ
  2. 現在のノード: ユーザーが現在表示している特定のページ
  3. 親階層: 現在のページからルートまでの祖先の連鎖
  4. 表示制約: 利用可能な水平幅(responsive-grid-system から)

出力

  1. 経路案内図: ラベル、区切り文字、リンクの定義された構造
  2. トランケーション戦略: 小さな画面やオーバーフローシナリオでの長いパスを処理するルール
  3. レスポンシブマッピング: トレイルがモバイルビューポートで折りたたまれる、または変換される方法
  4. セマンティックアクセシビリティレイヤー: スクリーンリーダー向けの定義されたARIAロールとラベル

ワークフロー

1. 階層パスのマッピング

ホーム/ルートから現在のページまでの絶対パスを特定します。 例: ホーム > リソース > ホワイトペーパー > [現在のページタイトル]

2. ビジュアルアナトミーの定義

各コンポーネントのスタイルを確立します。

  • リンク: 標準リンクスタイル(interactive-state-system から)
  • 区切り文字: 非インタラクティブな記号(例:/、>、→)で、階層を視覚的に区別します。
  • 現在のページ: クリック不可のプレーンテキストラベルで、ユーザーの現在地を確認します。

3. 空間リズムの確立

fluid-spacing-system を適用します。

  • ギャップ: リンクと区切り文字の間には、一貫性のある小さなスペース(例:--space-xs)を使用します。
  • 垂直配置: トレイルはメインの <h1> の上、かつグローバルサイトヘッダーの下に一貫して配置します。

4. トランケーションとオーバーフローの実装

深いパス(4階層以上)や長いタイトルの場合:

  • 中央トランケーション: 合計幅がコンテナを超える場合、中間階層を省略記号(...)に折りたたみます(例:ホーム > ... > セクション > ページ)。
  • ラベルトランケーション: 個々の長いラベルには max-width と text-overflow: ellipsis を使用し、折り返しを防ぎます。

5. レスポンシブ適応の計画

モバイル体験をマッピングします。

  • 「親に戻る」パターン: 非常に小さな画面では、フルトレイルを単一の「<- [親]に戻る」リンクに置き換えてスペースを節約します。
  • 水平スクロール: フルトレイルを保持する必要がある場合、パンくずリストを水平スクロール可能にします。

決定ルール

  • 「常にルート」ルール: トレイルの最初の項目は常に機能的なルート(通常は「ホーム」)でなければなりません。
  • 現在のページ状態: パンくずの最後の項目(現在のページ)はリンクにしてはいけません。これにより、ユーザーが既にいるページへのリンクをクリックすることを防ぎます。
  • 論理 vs 履歴: パンくずはサイト構造を反映しなければならず、ユーザーのブラウザ履歴を反映してはいけません。
  • 区切り文字の視覚的優先度: 区切り文字はリンクよりも視覚的な重みを低く(例:薄い色)して、注意を競わないようにします。

制約

  • アクセシビリティ: <nav> 要素で aria-label="Breadcrumb" と共にラップし、順序付きリスト(<ol>)アイテムを含める必要があります。これによりスクリーンリーダーが位置と総数を通知します。
  • コントラスト: リンクと区切り文字はWCAG AA (4.5:1) の要件を満たす必要があります。
  • タッチターゲット: パンくずリンクは、表示テキストが小さくても、WCAG 2.2 SC 2.5.8 の最低24x24pxの要件を満たす必要があります。
  • 長さ: パンくずラベルはページタイトルと完全に一致させるか(タイトルが極端に長い場合は短縮バージョンを使用)、一致させる必要があります。

よくある失敗パターン

  • 「ホーム喪失」: ホーム/ルートへのリンクを含めないため、ユーザーはメインメニューからやり直さざるを得なくなる。
  • リンク過剰: 現在のページをクリック可能なリンクにしてしまい、同じページを再読み込みしてユーザーを混乱させる。
  • 視覚的競合: 区切り文字が大きすぎたりコントラストが高すぎたりして、トレイルが読みにくくなる。
  • 折り返しの破綻: モバイルでパンくずが3行以上に折り返され、メインコンテンツがページの下に押しやられる。
  • IAの不整合: ユーザーの到達方法によって同じページに異なるパスが表示される。

検証基準

  • トレイルはホーム/ルートノードから始まっている。
  • 現在のページは最後の項目であり、クリック不可である。
  • パンくずは <nav aria-label="Breadcrumb"> ランドマークでラップされ、<ol> リストを含んでいる。
  • 視覚的な区切り文字が使用され、リンクよりもコントラストが低い。
  • トレイルはモバイルビューポートに適切に適応する(トランケーションまたは「戻る」リンク)。
  • アイテム間のスペーシングは一貫しており、流体スペーシングシステムに従っている。
  • キーボードユーザーは Tab キーで中間リンク間を移動できる。

Individual skills in this repo

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

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

関連スキル