---
{
  "n": 107,
  "title": "rule 27 \u2014 Name a declaration with the word a reader already knows",
  "abstract": "",
  "refs": [],
  "seen": [
    "system",
    "agent"
  ],
  "data": {
    "feature": "rules",
    "session": "aa7b0113-6875-4844-9251-b121d8830cf3",
    "private": true,
    "whisper": true,
    "lead": false,
    "yields": true,
    "reply_kept": false
  },
  "created": 1791707431.386153,
  "updated": 1791707432.405181,
  "deleted": 0.0,
  "completed": 0.0,
  "outcome": "",
  "type": "nudge"
}
---
An attribute, a variable or a field gets the ordinary programming word for what it holds, not an evocative one. was, heard and alone were poetry; aliases, notify_actions and urgent_actions are what they are. The test: could a reader who has never seen this codebase guess what it holds from the name alone? Prose belongs in the help text and the abstract, where it is read as prose. This does not license abbreviations — a plain word in full, not a short one.