repository-structure

リポジトリ構造定義書を作成するスキル

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026

When & Why to Use This Skill

This Claude skill automates the creation of comprehensive repository structure definition documents to ensure architectural consistency across development teams. By analyzing existing architecture designs and technology stacks, it generates standardized directory layouts, naming conventions, and path aliases, facilitating better codebase maintainability and smoother developer onboarding.

Use Cases

  • New Project Initialization: Automatically design and document a scalable folder structure tailored to specific technology stacks (e.g., React, Go, or Python) during the early stages of development.
  • Team Standardization: Establish a 'source of truth' for file organization across multiple microservices or repositories to ensure all team members follow the same structural patterns.
  • Developer Onboarding: Generate a clear map of the codebase (docs/repository-structure.md) that helps new engineers quickly locate components, logic, and assets within a complex repository.
  • Refactoring and Migration: Provide a blueprint for reorganizing legacy codebases into modern, modular structures based on updated architectural principles.
namerepository-structure
descriptionリポジトリ構造定義書を作成するスキル

Repository Structure Skill

目的

開発チームが一貫性のあるファイル配置を行えるよう、リポジトリの構造を明確に定義します。

前提条件

このスキルを実行する前に、以下のスキルが完了している必要があります:

  • architecture-design: docs/architecture.md が作成されていること

入力

  • docs/architecture.md

出力

docs/repository-structure.md - リポジトリ構造定義書

実行手順

  1. アーキテクチャ設計書を読み込む
  2. 技術スタックに基づいたディレクトリ構造を設計する
  3. template.mdを参照してドキュメントを作成する
  4. 命名規則とパスエイリアスを定義する
  5. 実例を含めて具体的に記述する

参照ファイル

  • template.md - リポジトリ構造定義書のテンプレート
  • guide.md - 作成時のガイドライン(ディレクトリ設計や命名規則)

使い方

このスキルを使用する際は、以下の流れで作業します:

  1. テンプレートの確認: template.mdでドキュメント構造を把握
  2. ガイドラインの理解: guide.mdで作成時の注意点を確認
  3. ドキュメント作成: テンプレートに従ってdocs/repository-structure.mdを作成
  4. 品質チェック: スケーラビリティと保守性を考慮して検証