convention-folder-structure

Organize Python monorepo folder layouts with libs/{name}/src/{name}/__init__.py structure.

Updated Mar 19, 2026

Search Tags:#architecture #python #monorepo #folder-structure #project-organization

Ready to run

npx skills add https://github.com/sunLeee/optimization --skill convention-folder-structure

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: convention-folder-structure
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/quality/style/folder-structure
Command: npx skills add https://github.com/sunLeee/optimization --skill convention-folder-structure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes a standardized, scalable folder layout for Python monorepos and DS/Agent projects to reduce onboarding time and architectural drift.

Core Features & Use Cases

Provides explicit guidelines for monorepo, single-package, DS, and agent structures.
Enforces required footprint for new libraries (libs/{name}/src/{name}/init.py) and shared utilities (libs/utils/).
Guides project evolution with concrete examples and best practices for organizing libs, agents, apps, tests, and docs.

Quick Start

Apply the folder-structure conventions when adding new libraries or shared utilities to ensure libs/{name}/src/{name}/init.py and libs/utils/ are created as described.

Frequently Asked Questions about convention-folder-structure

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

FAQPage Schema

What is the best way to organize a Python monorepo folder structure?▼

A scalable Python monorepo folder structure organizes new libraries under libs/{name}/src/{name}/__init__.py and shared utilities under libs/utils/, reducing onboarding time and architectural drift.

How do I structure a scalable Python project layout for data science?▼

Scalable Python project layouts for data science guide where libs, apps, agents, tests, and docs live, ensuring standardized organization across DS projects and agent-based architectures.

Can I use this folder structure convention for agent-based architectures?▼

Yes, the folder structure convention applies to agent-based architectures by providing explicit guidelines for organizing agents, apps, and shared utilities within a standardized monorepo layout.

Where should shared utilities live in a Python monorepo?▼

Shared utilities in a Python monorepo should live under the libs/utils/ directory, following the standardized footprint to ensure consistent project organization and reduce architectural drift.

Do I need to follow specific rules when adding new libraries to a monorepo?▼

When adding new libraries to a monorepo, you must create the required footprint of libs/{name}/src/{name}/__init__.py to enforce standardized folder layouts and maintain structural consistency.

Why does my Python project layout suffer from architectural drift?▼

Python project layouts suffer from architectural drift when lacking standardized folder structure conventions, resulting in inconsistent placement of libraries, utilities, tests, and documentation across the monorepo.