Back to list
yuch4

repository-structure

by yuch4

0🍴 0📅 Jan 13, 2026

SKILL.md


name: repository-structure description: > PRD・機能設計・アーキテクチャからリポジトリ構造定義書(docs/repository-structure.md)を作成する。 「ディレクトリ構成を決めて」「フォルダ構造を設計」「ファイル配置ルール」「プロジェクト構造」 「どこに何を置くか決めて」などの依頼時に発火。 ディレクトリ責務・命名規則・依存ルール・テスト配置・スケーリング方針を出力。

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 スキル
  • 実際のディレクトリ作成 → 開発タスクとして別途実施

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon