Cognitive Load

Reduce cognitive load by extracting complex conditionals, using early returns to flatten nested logic, and replacing deep inheritance with composition. These techniques minimize mental effort required to understand code structure and intent.

Guard clauses are conditional checks that exit a function early when preconditions fail, eliminating deep nesting. They improve readability by letting readers follow the happy path without tracking multiple indentation levels.

Prefer composition over inheritance to reduce cognitive load from tracking class hierarchies and method resolution. Composition keeps business logic self-contained and easier to reason about than inheritance chains.

Use a cognitive-load checklist to evaluate functions for nested conditionals, unclear variable names, and inheritance depth. Refactor identified issues by extracting named booleans, simplifying logic, and flattening module structure.

Self-describing status codes reduce cognitive load by eliminating the need to cross-reference numeric values with documentation. Descriptive names communicate intent directly, making code intent immediately clear to readers.