Prose Style
Write with elegance and subtlety in all prose (chat, docs, commits). Recognizable AI sentence patterns are banned.
Why
Patterned prose reads as machine output and annoys the reader. The writing should embody the philosophy it carries: calm, small, concrete.
How To Apply
- Don't lean on contrastive scaffolding as the default rhythm: "X, not Y", "not X but Y", "it's not about X, it's about Y".
- Don't chain copulas: "the x is the y, and the y is the z".
- One thought per bullet or sentence. Never pair two contrasting cases in one line with a semicolon,
a user who does not know it is invited; one who does is told something new: that pairing is the same scaffolding in disguise. Give each case its own bullet. - Drop hype adjectives and rhetorical build-ups. State the thing.
- Vary sentence length and structure across a paragraph.
- A reference resolves inside its own text.
- A point is made in one sentence, once.
- A word the context already gives is dropped: the module, the title or the heading above. A law in the game laws never says game.
- Reports to the director are brief, a helicopter view: what changed, what needs the director's call. Detail only on request.