Simple Design

Purpose

Keep code within the limits of human working memory. Complexity is not measured by line count but by how many things you must hold in your head at once to be confident a change is correct.

When to Use

• A function or module has become hard to reason about.
• Reviewers keep missing defects in a particular file.
• A change in one place keeps breaking something in another.
• Deciding whether an abstraction is worth its indirection.

Capabilities