repo-structure-reviewlisted

## Purpose 「コードが増えるにつれてどこに何があるかわからなくなる」を防ぐ。 ファイル配置・命名・依存方向が設計原則と整合しているかを定期的に確認し、 構造的な技術的負債の蓄積を防ぐ。 ## Use When - 新機能追加・リファクタリングの前後にリポジトリ構造を確認したい場合 - 「このファイルはどこに置くべきか」の判断基準を整理したい場合 - チームや施工AIに構造のルールを伝えたい場合 - 構造の乱れが保守コストに影響し始めたと感じた場合 ## Inputs 以下を準備すること。不足している場合は推測せず、不足を明示する。 - **レビュー対象**: 確認したいディレクトリ・ファイル群（または全体） - **設計原則・規約**: 現在のプロジェクトの構造ルール（あれば） - **技術スタック**: フレームワーク（Next.js App Router 等）・言語 - **最近の変更**: 直近で追加・変更したファイルの概要 - **懸念点**: 「ここがおかしい気がする」という観察（任意） ## Output Contract 以下の順で出力すること。順序を変えない。 1. **論点**: このリポジトリ構造の問題を左右する核心的な判断軸 2. **根拠**: その論点をそう判断した理由 3. **構造レビュー結果**: カテゴリ別の評価 4. **含意**: 現在の構造が示す設計上の健全性・リスク 5. **改善案**: 最小変更で構造を改善するための具体的な手順 6. **代替案**: 大規模な再構成が必要な場合の段階的アプローチ 7. **判断材料**: 「今すぐ修正 / 次フェーズで修正 / 現状維持」を選ぶための情報 ### 構造レビュー結果 フォーマット | カテゴリ | 状態 | 問題点・推奨 | |---|---|---| | ディレクトリ構造の一貫性 | OK / 注意 / NG | | | ファイル命名規則の統一性 | OK / 注意 / NG | | | 依存方向（循環依存・逆依存） | OK / 注意 / NG | | | コロケーション原則（関連ファイルの近接配置） | OK / 注意 / NG | | | フレームワーク規約への準拠（App Router 等） | OK / 注意 / NG | | | テストファイルの配置 | OK / 注意 / NG | | | 設定ファイル・環境変数の管理 | OK / 注意 / NG | | | 不要・重複ファイルの存在 | OK / 注意 / NG | | ## Review Lens - **目的妥当性**: レビュー観点が保守コストに直結しているか - **範囲の過不足**: フレームワーク固有の規約を見落としていないか - **中長期リスク**: 現在の構造が機能追加時に複雑度を急増させないか - **LAB全体との整合性**: Next.js App Router の規約・Supabase のファイル配置と整合しているか - **非エンジニア理解可能性**: 構造の問題と改善案を非技術者に説明できるか - **他LLM移植耐性**: 評価基準が Claude 固有の解釈に依存していないか ## Instructions 1. フレームワーク（Next.js App Router 等）の標準構造と比較する 2. ディレクトリごとに「何を置くべきか」の責務を確認する 3. 命名規則（camelCase / kebab-case