B-119 ディレクトリ構造リファクタリング実施計画

1. ゴール

誰のために

プロジェクトのコードを読み書きするAIエージェント自身の生産性向上のため。現在、1つのフィーチャーに関するファイルが3-4箇所に散在しており、機能追加・変更・バグ修正時に関連ファイルの把握に時間がかかる。とくにgames（153ファイルが4箇所）が深刻。

この作業によって提供する価値

フィーチャー単位の凝集度向上により、機能追加・修正・削除が1ディレクトリ内で完結する
新しいフィーチャー追加時のテンプレートが明確になる
コードベースの見通しが良くなり、AIエージェントの作業精度と速度が向上する
結果としてサイトの品質改善サイクルが加速し、PV向上に寄与する

完成の定義

すべてのフィーチャーが src/features/ 配下にコロケーションされていること
src/components/ には共有コンポーネント（common/）のみが残ること
src/lib/ にはフィーチャー固有でない共有ユーティリティのみが残ること
src/data/ ディレクトリが廃止されていること
npm run typecheck, npm run test, npm run build がすべてパスすること
pre-commit hook（prettier, eslint, tsc, memo-lint）がすべてパスすること
既存のURL構造に変更がないこと
path alias @/* -> ./src/* の設定が変更されていないこと

2. 構造案の最終決定

決定: 案Bフィーチャーベース完全統合型を採用（一部修正あり）

リサーチャーの案Bを基本的に採用するが、以下の修正を加える。

修正点

修正1: 共有データ（src/data/）の配置

ゲーム専用データ（*-schedule.json, nakamawake-data.json）は features/games/ 配下の各ゲームに配置
dictionary/gamesの両方から参照されるデータ（kanji-data.json, yoji-data.json, traditional-colors.json）は src/data/ に残す。ただし名前を src/shared-data/ に変更して「意図的な共有データ」であることを明示する

理由: features/dictionary/data/ に配置すると features/games/ から features/dictionary/ への依存が生まれ、フィーチャー間の結合度が上がる。共有データは明示的な共有レイヤーに置くほうがフィーチャーの独立性が高い。

修正2: blog/content/ の配置

ブログのMarkdownファイルは src/content/blog/ のまま移動しない。features/blog/ 内にはlib, componentsのみを配置する
理由: Markdownコンテンツファイルはコードではなくデータであり、features/blog/content/ に置くとコードとデータの境界が曖昧になる。また lib/blog.ts のパスが process.cwd() ベースでハードコードされているので、パスの一貫性を保つため

修正3: searchは features/ に移動しない

search は複数フィーチャーを横断する基盤機能であり、独立した「フィーチャー」ではない
src/lib/search/ と src/components/search/ はそのまま残す（共有レイヤーとして扱う）

最終ディレクトリ構造

src/
  app/                        # ルーティング層（変更なし）
  features/                   # フィーチャーごとの完全なコード
    tools/
      [各ツール32個]/            # Component.tsx, Component.module.css, logic.ts, meta.ts, __tests__/
      components/              # src/components/tools/ から移動
        ToolCard.tsx, ToolCard.module.css
        ToolLayout.tsx, ToolLayout.module.css
        ToolsGrid.tsx, ToolsGrid.module.css
        ToolsListView.tsx, ToolsListView.module.css
        RelatedTools.tsx, RelatedTools.module.css
        RelatedBlogPosts.tsx, RelatedBlogPosts.module.css
        ErrorBoundary.tsx
        __tests__/
      registry.ts
      types.ts
    cheatsheets/
      [各チートシート3個]/       # Component.tsx, meta.ts
      components/              # src/components/cheatsheets/ から移動
        CheatsheetCard.tsx, ...
        CheatsheetLayout.tsx, ...
        CodeBlock.tsx, ...
        RelatedCheatsheets.tsx, ...
        TableOfContents.tsx, ...
        __tests__/
      registry.ts
      types.ts
    games/
      kanji-kanaru/
        components/            # src/components/games/kanji-kanaru/ から移動
        lib/                   # src/lib/games/kanji-kanaru/ から移動
        data/                  # ゲーム固有データ（puzzle-schedule.json）
      yoji-kimeru/
        components/            # src/components/games/yoji-kimeru/ から移動
        lib/                   # src/lib/games/yoji-kimeru/ から移動
        data/                  # ゲーム固有データ（yoji-schedule.json）
      nakamawake/
        components/            # src/components/games/nakamawake/ から移動
        lib/                   # src/lib/games/nakamawake/ から移動
        data/                  # ゲーム固有データ（nakamawake-data.json, nakamawake-schedule.json）
      irodori/
        components/            # src/components/games/irodori/ から移動
        lib/                   # src/lib/games/irodori/ から移動
        data/                  # ゲーム固有データ（irodori-schedule.json）
      shared/
        components/            # src/components/games/shared/ から移動
        lib/                   # src/lib/games/shared/ から移動
      registry.ts              # src/lib/games/registry.ts から移動
      types.ts                 # src/lib/games/types.ts から移動
    quiz/
      components/              # src/components/quiz/ から移動
      data/                    # src/lib/quiz/data/ から移動
      lib/                     # scoring.ts を配置
      registry.ts
      types.ts
      __tests__/               # src/lib/quiz/__tests__/ から移動
    dictionary/
      components/              # src/components/dictionary/ から移動
      lib/                     # src/lib/dictionary/ から移動（kanji.ts, yoji.ts, colors.ts, index.ts, types.ts）
    blog/
      components/              # src/components/blog/ から移動
      lib.ts                   # src/lib/blog.ts から移動
    memos/
      components/              # src/components/memos/ から移動
      lib.ts                   # src/lib/memos.ts から移動
      lib-shared.ts            # src/lib/memos-shared.ts から移動
  content/                     # コンテンツデータ（変更なし）
    blog/                      # ブログMarkdownファイル
  shared-data/                 # src/data/ をリネーム（辞典とゲーム両方から参照される共有データ）
    kanji-data.json
    yoji-data.json
    traditional-colors.json
  components/                  # 共有コンポーネントのみ
    common/                    # Header, Footer, Breadcrumb, Pagination 等（変更なし）
  lib/                         # 共有ユーティリティのみ
    constants.ts
    cross-links.ts
    date.ts
    feed.ts
    feed-memos.ts
    markdown.ts
    ogp-image.tsx
    pagination.ts
    search/                    # 検索機能（フィーチャー横断のため共有層に残す）
    seo.ts
    __tests__/                 # 共有lib用テスト（constants, date, markdown, pagination, ogp-image, seo 等）
  types/                       # サードパーティ型定義（変更なし）
  test/                        # テストセットアップ（変更なし）

各フィーチャーの配置先詳細

移動元	移動先
src/tools/	src/features/tools/（ツール定義をそのまま移動）
src/components/tools/	src/features/tools/components/
src/cheatsheets/	src/features/cheatsheets/（定義をそのまま移動）
src/components/cheatsheets/	src/features/cheatsheets/components/
src/lib/games/	src/features/games/ 配下に分散配置
src/components/games/	src/features/games/ 配下に分散配置
src/data/*-schedule.json	src/features/games/各ゲーム/data/
src/data/nakamawake-data.json	src/features/games/nakamawake/data/
src/data/kanji-data.json, yoji-data.json, traditional-colors.json	src/shared-data/
src/lib/quiz/	src/features/quiz/
src/components/quiz/	src/features/quiz/components/
src/lib/dictionary/	src/features/dictionary/lib/
src/components/dictionary/	src/features/dictionary/components/
src/lib/blog.ts	src/features/blog/lib.ts
src/components/blog/	src/features/blog/components/
src/lib/memos.ts	src/features/memos/lib.ts
src/lib/memos-shared.ts	src/features/memos/lib-shared.ts
src/components/memos/	src/features/memos/components/

共有ライブラリ（lib/）の整理方針

以下のファイルはフィーチャー固有ではないため src/lib/ に残す:

constants.ts（全体で使用）
cross-links.ts（blog + memos を横断）
date.ts（共通ユーティリティ）
feed.ts, feed-memos.ts（全体で使用）
markdown.ts（共通ユーティリティ）
ogp-image.tsx（全体で使用）
pagination.ts（共通ユーティリティ）
search/（フィーチャー横断の基盤機能）
seo.ts（フィーチャー横断の基盤機能）

cross-links.ts のインポートパスは @/lib/blog -> @/features/blog/lib, @/lib/memos -> @/features/memos/lib に更新する。 seo.ts のインポートは @/tools/types -> @/features/tools/types, @/cheatsheets/types -> @/features/cheatsheets/types, @/lib/quiz/types -> @/features/quiz/types に更新する。 search/build-index.ts のインポートは全フィーチャーのregistryパスに更新する。

3. 移行計画

移行の原則

1フェーズ = 1フィーチャーの移行
各フェーズは独立したコミットとする
各フェーズ完了後に必ず typecheck + test + build を実行して健全性を確認
フェーズ間の依存がないよう、各フェーズ内で完結するようにする

フェーズ0: 準備（共有データの分離）

作業内容:

src/data/ を src/shared-data/ にリネーム
src/shared-data/ には kanji-data.json, yoji-data.json, traditional-colors.json のみを残す
ゲーム固有データ（*-schedule.json, nakamawake-data.json）は一旦 src/shared-data/ に含めておく（フェーズ2で各ゲームに移動）
全ファイルの @/data/ インポートを @/shared-data/ に更新（6ファイル）

影響ファイル:

src/components/games/kanji-kanaru/GameContainer.tsx
src/components/games/yoji-kimeru/GameContainer.tsx
src/components/games/nakamawake/GameContainer.tsx
src/components/games/irodori/GameContainer.tsx
src/lib/dictionary/kanji.ts
src/lib/dictionary/yoji.ts
src/lib/dictionary/colors.ts