Folder structure

Organization

• Organize by capability first; keep technical subdivisions inside their owning capability.
• Name folders by responsibility; avoid catch-all utils, helpers, common, and misc directories.
• Use the same internal organization for modules with equivalent responsibilities.
• Create directories for existing responsibilities, not anticipated architecture.

Ownership

• Keep capability-specific code with its owner, even when other capabilities consume it.
• Place contracts with the module that owns their meaning.
• Share code only when multiple existing capabilities require the same behavior and contract.
• Keep shared modules independent of the capabilities that consume them.

Dependencies