Comment by needfish

In my opinion code works when it works so there is less reason to care about the weeds. When code is a communication of intent between people, or even just between a person and their future self, learning to encode that intent well into the code takes practice. There are entire fields people have developed over this, like domain-driven design or data-oriented programming, ensuring the data shows what it means semantically.

It is impossible to reconstruct the intent/spec from the code. More often than not the intent is not clear in the code, and one has to track down the original author to check their context and decision at the time.

As the saying goes, naming things well is a hard problem. It's kinda mystical in a way, where only by knowing an entity's true name will one understand it.

However if it's communicated between agents one may care even less.