11 — Voice
Playful but precise. The voice of someone who knows the product cold and respects the reader's time. Lovable's warmth, Linear's economy. If a sentence sounds like a press release, rewrite it.
01
Plain over clever
Say the thing. Don't dress it up. If the sentence sounds like a brochure, rewrite it as if you were telling a friend.
02
Short sentences. One idea each.
Vary length, but lean short. Long sentences belong in the README, not the hero. Use periods like fences.
03
Specific beats vague
"Deploy in under a minute" beats "Fast and reliable." Numbers, nouns, verbs — not adjectives stacked on adjectives.
04
Cheeky, never smug
A little wink is fine. Punching down isn't. We are not the smartest thing in the room — paige is.
05
Developer-aware, not jargon-soaked
Talk about APIs, deploys, flows — but assume the reader sells things, not ships infrastructure. Define unusual terms once, then use them.
Rhythm
Vary length. Lean short.
A paragraph that's all medium sentences sounds robotic. A paragraph that's all short sentences sounds breathless. Aim for a mix — most short, the occasional longer one to give the reader a place to breathe. Read everything aloud. If you run out of air, the sentence is too long.
Example. Paige writes the bot. You describe what you want, in plain English, and the agent builds the flow — including the WhatsApp template, the code that handles incoming messages, and the database table for orders. Deploy is one click. You don't touch infrastructure. Ever.