Backend 621 installs

Python Project Structure & Module Architecture

by wshobson/agents

Python project organization, module architecture, and public API design. Use when setting up new projects, organizing modules, defining public interfaces with…

Skill content

Python Project Structure & Module Architecture

Design well-organized Python projects with clear module boundaries, explicit public interfaces, and maintainable directory structures. Good organization makes code discoverable and changes predictable.

When to Use This Skill

- Starting a new Python project from scratch

- Reorganizing an existing codebase for clarity

- Defining module public APIs with __all__

- Deciding between flat and nested directory structures

- Determining test file placement strategies

- Creating reusable library packages

Core Concepts

1. Module Cohesion

Group related code that changes together. A module should have a single, clear purpose.
#agents #wshobson
Back to all skills