---
name: James's writing voice for promos
description: Detailed voice guide for writing promotional content — short sentences, no AI slop, Australian casual, system-level framing
type: feedback
originSessionId: 98a759e1-c796-41c8-93e9-e2059d06aae8
---
User provided a detailed voice breakdown for all promotional writing. Key rules:

**Do:** Lead with the verdict. Short sentences. Drop articles when meaning is obvious. Swear occasionally as punctuation not edge. Weird specific analogies ("as useful as a paper bag in the Mariana Trench"). Frame problems structurally not emotionally. State what it does and shut up.

**Don't:** Em dashes everywhere. "Leverage", "empower", "seamless", "revolutionary", "game-changer". Opening with "In today's..." or "As a...". Hedging: "arguably", "it's worth noting". Exclamation marks. The word "journey". "At [company], we believe..."

**Why:** User explicitly said "if it sounds like a LinkedIn post, burn it." First draft of promo content was rejected as "AI tells" — rewrote in his voice and it landed.

**How to apply:** Any time writing external-facing content (README copy, social posts, articles, product descriptions). Write like talking fast. Under 15 words per sentence where possible. Vary rhythm — one long, two short, fragment.

**Key framing for repo-graph:** "Code is already a graph. LLMs process graphs. repo-graph connects the two." Not "tourist with no map" — that undersells it. The structure already exists in the code, repo-graph just extracts it.
