Vague Names Become Design Decisions When AI Writes the Code Around Them

A sloppy variable name used to be a cosmetic flaw a teammate would mentally correct while reading. With an AI assistant generating thousands of lines from that name, it stops being cosmetic and becomes the blueprint for everything built next.

The Details:

• Models generate outward from vocabulary, not from design intent. Call a keyed lookup something like a list, and the assistant will build downstream modules that treat it as a list, iterating and indexing it in ways that only surface as bugs once the shape mismatch finally breaks something. The name did not just describe the thing; it dictated how the thing would be used.

• Imprecision breeds more imprecision. A generic name in an early file signals low specificity to the model, which then reaches for equally vague children: handler, manager, processor, factory. None of these classes were consciously designed. They accreted because each one was a plausible-sounding patch over a concept nobody had actually pinned down.

• The fix is cheapest at the exact moment it feels least necessary. Renaming a variable in the first generated file, before the model has touched anything downstream, costs almost nothing. Waiting until the vocabulary has shaped conditionals, loop structures, and test fixtures turns the same fix into a structural untangling job.

• The leverage window is not a one-time event. It reopens every time a session crosses into new territory: a new service, a new subsystem, a new domain concept. Each crossing offers the same cheap moment to fix the vocabulary before it hardens, and each one closes just as fast once generation continues.

Bottom Line: The names typed in the first thirty lines are not labels, they are the contract the model builds every subsequent file against.

A developer who pauses to name things precisely gets an assistant that extends real intent. One who does not gets a rogue inference engine, building a structure nobody asked for at a scale no one can review after the fact.