majiayu000 Repository Structure Skill
アーキテクチャ設計の「どう構成するか」を「どこに何を置くか」に落とし込む。
入出力
| 種別 | パス |
|---|---|
| 入力 | docs/product-requirements.md（PRD） |
| 入力 | docs/functional-design.md（機能設計） |
| 入力 | docs/architecture.md（アーキテクチャ） |
| 入力 | docs/repository-structure.md（既存あれば優先） |
| 出力 | docs/repository-structure.md |
参照ファイル
| ファイル | 読むタイミング |
|---|---|
./template.md |
新規作成時のベース |
./reference.md |
設計原則・命名規則・レビュー観点 |
手順
1. 設計情報の抽出
アーキテクチャ・機能設計から以下を抽出：
- レイヤー構成（UI / Service / Repository等）
- 主要コンポーネント・機能モジュール
- テスト戦略（Unit / Integration / E2E）
- 技術スタック（FW固有の構造があるか）
2. 既存定義の確認
docs/repository-structure.mdが存在する？- Yes → 構造を維持して差分更新
- No →
./template.mdをコピーして新規作成
3. 構造設計
./template.md の構造に従い、以下を埋める：
| セクション | 内容 | 必須 |
|---|---|---|
| ルート構造 | トップレベルディレクトリ一覧 | ✅ |
| src/ 詳細 | 各ディレクトリの責務・配置ルール | ✅ |
| 命名規則 | ディレクトリ・ファイル・クラス・関数 | ✅ |
| 依存関係ルール | レイヤー間の依存方向 | ✅ |
| テスト配置 | Unit / Integration / E2E の構造 | ✅ |
| docs配置 | ドキュメント群の配置ルール | ✅ |
| スケーリング方針 | 分割タイミング・方法 | ✅ |
4. アーキテクチャとの整合性チェック
- アーキテクチャのレイヤー構成がディレクトリに反映されている
- 依存ルールがアーキテクチャと一致している
- テスト戦略がテスト配置に反映されている
5. 出力
docs/repository-structure.md を作成/更新し、変更点をサマリ提示
発火例
- 「ディレクトリ構成を決めて」
- 「フォルダ構造を設計して」
- 「プロジェクト構造を整理して」
- 「どこに何を置くかルール化して」
- 「テストファイルの配置を決めて」
境界（やらないこと）
- 技術選定 →
architecture-designスキル - コーディング規約（命名以外） →
development-guidelinesスキル - 実際のディレクトリ作成 → 開発タスクとして別途実施