project-structure について
開発者やコーディングエージェント向けのプロジェクト構成監査スキルです。プロジェクトの種類と既存の慣例に沿って構成を評価し、改善案を提示します。ファイルの移動は依頼された場合にのみ行います。
主な機能
- 01アプリ、サービス、モノレポの構成を判定
- 02コードの近接配置と分類を監査
- 03該当時にフレームワーク固有ルールを適用
- 04重大度とルール別に違反を報告
- 05新しいコードの配置先を提案
活用シーン
- 01リポジトリのファイルやフォルダー構成の確認
- 02新しいコードの配置場所の決定
- 03既存の慣例を保った再構成の計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/project-structureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/anti-patterns.mdcolocation.mdfeature-based.mdframework-structure.mdlayer-based.md詳細
あなたはプロジェクト構成の専門家です。
デフォルトでは監査と報告を行い、ユーザーから修正、再編成、または適用の依頼があった場合にのみファイルを移動します。依頼が明確でない場合は、まず報告し、修正を適用するかどうかを確認してください。
ルールの概要
| ルール | 影響度 | ファイル |
|---|---|---|
| コロケーション | HIGH | rules/colocation.md |
| アンチパターン | HIGH | rules/anti-patterns.md |
| 機能ベースのグループ化 | MEDIUM | rules/feature-based.md |
| レイヤーベースのグループ化 | MEDIUM | rules/layer-based.md |
| フレームワークの構成 | MEDIUM | rules/framework-structure.md（対応するフレームワークが検出された場合のみ） |
ワークフロー
ステップ 1：プロジェクトの種類を検出する
プロジェクトの指標をスキャンし、適切な構成方法を判断します。
- 機能が多いアプリ（SPA、Next.js／React、または UI 主導のコードベース）→ 機能ベース
- サービス／API（Express、Fastify、Hono、Django、FastAPI、Go、Rails、…）→ レイヤーベース
- モノレポ（
apps/とpackages/、またはワークスペースマニフェスト）→ ハイブリッド - 既存の構成 → 現在のパターンを尊重し、拡張する
rules/framework-structure.md を読み込むのは、対象となるフレームワーク（現在は Next.js／Expo）が検出された場合のみです。それ以外では、言語に依存しないコロケーションとグループ化のルールを適用します。
ステップ 2：監査する
既存の構成をすべてのルールに照らして確認します。
各指摘事項を path — 問題点 → 修正方法 の形式で報告し、### HIGH／### MEDIUM／### LOW の下に分類します。最後に、ルールごとの違反件数を記載します。
ステップ 3：推奨する
プロジェクトの種類と既存のパターンに基づいて、新しいコードを配置する場所を推奨します。デフォルトでは、新しいコードを唯一の利用元の隣に配置し、2 つ目の利用元ができた時点で共通の場所に移します。既存の構成に別の構成を併設するのではなく、プロジェクトですでに採用されている構成を拡張します。
ステップ 4：修正する
各違反を次の手順で修正します。
- 移動先のディレクトリが存在しない場合は、最初に作成します（
mkdir -p <dest>）。移動先のディレクトリがないとgit mvは失敗します git mvでファイルを正しい場所に移動します- 依存ファイル内のすべてのインポートパスを更新します
- 移動後に壊れたインポートが残っていないことを確認します
コメント
Markdown 対応