---
{
  "n": 45,
  "title": "No prose words as names in code - said, says, heard, spoke, told, shown, became",
  "abstract": "",
  "refs": [],
  "seen": [
    "agent",
    "user"
  ],
  "data": {
    "keywords": [
      "said",
      "says",
      "heard",
      "told",
      "shown",
      "became",
      "alone"
    ],
    "keywords_in": "text"
  },
  "created": 1790027221.963275,
  "updated": 1790073760.620683,
  "deleted": 0.0,
  "completed": 0.0,
  "outcome": "",
  "type": "rule"
}
---
Messages 1360 and 1698. The user has said more than once that code must not read like prose: a variable, attribute, property or function is named for what it holds or does (text, command, labels, lines), never with a verb from a story. 'says' on the Design type (1360) and 'said = call.said.lower()' in features/recital.py (1698) are the examples. Rule 27 states the naming rule; this one carries the words, so writing one of them whispers it. Before writing a name, ask whether a reader who has never seen the code would know what it holds.
