repository-structure

Generate a repository-structure document from PRD and architecture inputs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/yuch4/dx-selecta --skill repository-structure-yuch4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repository-structure
Source: https://github.com/yuch4/dx-selecta/tree/main/.claude/skills/repository-structure
Command: npx skills add https://github.com/yuch4/dx-selecta --skill repository-structure-yuch4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill translates PRD, functional design, and architecture into a concrete repository structure document (docs/repository-structure.md). It helps teams define directory responsibilities, naming conventions, dependencies, test placement, and scaling guidelines.

Core Features & Use Cases

  • Extracts architectural and design inputs to outline file layout, module responsibilities, and docs placement.
  • Generates a structured repository-structure.md that enforces rules for directories, tests, and naming.
  • Use Case: A team producing a new project can generate a standardized repo layout from PRD, designs, and architecture notes.

Quick Start

Run the tool to generate the repository structure doc from existing docs: PRD at docs/product-requirements.md, functional design at docs/functional-design.md, architecture at docs/architecture.md, and existing docs/repository-structure.md if present.

Frequently Asked Questions about repository-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a repository structure document from product requirements and architecture notes?

To generate a repository structure document from product requirements and architecture notes, use a tool that reads inputs like docs/product-requirements.md, docs/functional-design.md, and docs/architecture.md to output a standardized docs/repository-structure.md defining directory layouts and naming conventions.

What is the best way to standardize folder layouts and test placement across multiple projects?

Standardizing folder layouts and test placement across projects requires a repository structure document that enforces rules for directory responsibilities, naming conventions, and test placement, ensuring consistent file layouts generated from functional design and architecture inputs.

How do I translate a PRD and functional design into a concrete directory structure?

Translating a PRD and functional design into a directory structure involves extracting architectural inputs to outline file layouts, module responsibilities, and docs placement, then generating a repository-structure.md that enforces rules for directories, tests, and naming.

Do I need existing architecture documentation to define repository structure and scaling guidelines?

Yes, defining repository structure and scaling guidelines requires existing architecture documentation, specifically docs/product-requirements.md, docs/functional-design.md, and docs/architecture.md, to extract the necessary architectural and design inputs for your repository layout.

What should be included in a repository structure document for a new software project?

A repository structure document for a new software project should include directory responsibilities, naming conventions, dependencies, test placement, and scaling guidelines, all derived from the project's PRD, functional design, and architecture notes.

Why does my repository structure lack consistent module responsibilities and naming conventions?

Your repository structure lacks consistent module responsibilities and naming conventions because it was not generated from a standardized repository-structure document that enforces rules for directories, tests, and naming based on architectural and design inputs.