Naming & Obviousness Review Lens

When invoked with $ARGUMENTS, focus the analysis on the specified file or module. Read the target code first, then apply the checks below.

Names are arguably the most important form of abstraction because a name claims what matters most about an entity. Because names appear at extreme frequency, mediocre names produce systemic complexity that no single example would suggest.

When to Apply

• Reviewing any code for readability and clarity
• When a variable, method, or class name feels wrong
• When code requires reading the implementation to understand the interface

Core Principles

The Isolation Test

Read a name without surrounding context. Does it convey what the entity is?