Skip to content

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.