リポジトリ・ディレクトリの複雑度

実地所感（主観）： この機能セットでは、Starlight 固有の wiring は比較的 少量でした。一つの integration 設定と content collection 定義でテーマ機能の 大半が揃います。

二言語 GitHub Pages サンプルでは次を明示的に追加しています。

• ベースパス、ロケール、Pagefind、数式、テーマ用の astro.config.mjs
• Starlight docs collection 用の src/content.config.ts
• 対になる src/content/docs/en/ と ja/ のツリー
• counter と Mermaid 用の小さな Astro コンポーネント
• 静的なフレームワーク直下ロケール redirect

標準外 Markdown 構文やテーマ構造変更では複雑度が増えますが、検索、i18n、 sidebar、TOC、dark mode、静的生成が統合されているため土台は小さく保てます。