Name Review

Boundary-aware naming review improves the system's conceptual vocabulary. Do not begin by renaming. First understand the target, its boundaries, and the concepts that names are supposed to carry.

Core Principle

A rename is only an improvement when it makes the system easier to reason about across time, contributors, tools, and boundaries.

Optimize for:

• one concept with one primary name
• one primary name that points to one concept
• related concepts forming coherent name families
• contrasting concepts contrasting clearly
• names that remain clear out of context

When To Use