repository-structure

リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用。

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 17, 2025

When & Why to Use This Skill

This Claude skill provides a comprehensive framework and standardized template for defining clear, maintainable repository structures. It helps developers and architects translate high-level technical requirements into a concrete directory layout, ensuring project consistency and long-term code maintainability by generating a dedicated repository structure definition document.

Use Cases

  • Initial Project Scaffolding: Creating a standardized directory map when starting a new software project to ensure all team members follow the same organizational logic.
  • Technical Documentation: Generating a 'docs/repository-structure.md' file that serves as a single source of truth for the project's file organization and technical stack placement.
  • Architecture Alignment: Ensuring that the physical file structure of a repository accurately reflects the decisions made in the PRD and architecture design documents.
  • Team Onboarding: Providing a clear, documented overview of the codebase structure to help new developers quickly navigate and understand where specific components reside.
namerepository-structure
descriptionリポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用。
allowed-toolsRead, Write

リポジトリ構造定義スキル

このスキルは、明確で保守しやすいリポジトリ構造を定義するための詳細ガイドです。

前提条件

リポジトリ構造定義を開始する前に、以下を確認してください:

必須ドキュメント

  1. docs/product-requirements.md (PRD)
  2. docs/functional-design.md (機能設計書)
  3. docs/architecture.md (アーキテクチャ設計書)

リポジトリ構造は、アーキテクチャ設計で決定された技術スタックとシステム構成を反映した具体的なディレクトリ構造を定義します。

既存ドキュメントの優先順位

重要: docs/repository-structure.md に既存のリポジトリ構造定義書がある場合、以下の優先順位に従ってください:

  1. 既存のリポジトリ構造定義書 (docs/repository-structure.md) - 最優先

    • プロジェクト固有のディレクトリ構造が記載されている
    • このスキルのガイドより優先する
  2. このスキルのガイド - 参考資料

    • 汎用的なテンプレートと例
    • 既存定義書がない場合、または補足として使用

新規作成時: このスキルのテンプレートとガイドを参照 更新時: 既存定義書の構造と内容を維持しながら更新

出力先

作成したリポジトリ構造定義書は以下に保存してください:

docs/repository-structure.md

テンプレートの参照

リポジトリ構造定義書を作成する際は、次のテンプレートを使用してください: ./template.md

詳細ガイド

さらに詳しい作成ガイドは次のファイルを参照してください: ./guide.md