Clean Architecture

Kind: style

Layer: Structural Core

Record: architecture:clean-architecture

Severity: recommended

Scope: application, system

Canonical: Ontology

A convention of concentric layers in which source dependencies point only inward, towards the use cases and entities.

Listed in Architecture principles, after Ports and Adapters Architecture and before Layered Architecture.

Requires

• Dependency Rule
• Use Cases
• Boundaries

Reinforces

• Dependency Inversion Principle (DIP)
• Testability

Enables

• Framework Independence

Conflicts with

• Layer Leakage

In tension with

• Boilerplate

Tensions

• Clean Architecture / Boilerplate

Violated by

• Layer Leakage

Refactored by

• Move Logic to the Domain
• Extract Interface
• Extract Adapter

Severity

• recommended

Category

• Codebase / System Architecture Styles

Reinforced by

• Ports and Adapters Architecture

Linked from

• The layer spine
• The direction axis
• Correctness / Determinism / Verification
• SOLID / Object-Oriented Design
• Codebase / System Architecture Styles
• Codebase / System Architecture Styles
• Core Vocabulary
• Domain Architecture
• SOLID / Object-Oriented Design
• Severity levels
• The resolutions