Package by Feature

Kind: principle

Layer: Structural Core

Record: architecture:package-by-feature

Severity: recommended

Scope: package, module

Canonical: Ontology

A design rule that code is grouped by the feature it serves, so one change stays inside one package.

Listed in Architecture principles, after Component-Based Architecture and before Microservices.

Requires

• Feature Cohesion

Reinforces

• Modularity
• Bounded Context

Enables

• Locality of Change

Conflicts with

• Package by Technical Layer Only

In tension with

• Shared Technical Concerns

Tensions

• Package by Feature / Shared Technical Concerns

Violated by

• Package by Technical Layer Only

Refactored by

• Repackage by Feature
• Extract Module

Severity

• recommended

Category

• Codebase / System Architecture Styles

Linked from

• The layer spine
• Domain Architecture
• Core Modular Design
• Codebase / System Architecture Styles
• Core Modular Design
• Severity levels
• The resolutions