Mysterious Name

Change Function Declaration Rename Variable Rename Field

Symptom

Identifiers that don't reveal intent — names like aFunc(), x, theData, temp, or one-letter loop variables that force every reader to reverse-engineer the code's purpose.

Goal

Names read as the domain — a function's purpose, a variable's role, a class's responsibility — visible in one glance.

Smellier version

function calc(d, t) {
  return d * t;
}

Fresher version

function distance(speed, time) {
  return speed * time;
}

Savings

Reduces onboarding time, accelerates code review, and lets future-you skim instead of decode.

Note

Every reading is a re-comprehension cost; bugs sneak in because what code does diverges from what its name suggests. Compounds in proportion to how many readers (humans + LLMs) touch the file.