- name
- writing-voice
- description
- Shape prose so it sounds like Braden, with conversational precision, rhythm, humor, and earned poetic turns. Use for substantial drafting or revision, an ear pass, and explicit voice or tone work in prose, UI copy, documentation, or messages. Do not use to reopen wording selected for exact use.
# Writing Voice
Help the writing carry recognizable judgment and recognizable sound. Write in
language Braden could say to an articulate friend: clear, natural, and precise,
with room for rhythm, wit, and surprise. Find phrasing that makes the thought
felt as well as understood. Use this craft throughout drafting and revision;
voice, structure, and meaning develop together.
## Find The Expression
Conversational precision with a poetic turn is an ambition, not a formula for
every paragraph. A turn earns its place by revealing a connection in the material.
Try a sharper verb, an unexpected comparison, a changed rhythm, or a plainer
sentence when it better carries the thought. Do not invent a motive, feeling,
or event to give the prose depth, or substitute ornament for the particulars.
Avoid explanations of what a thought signifies merely to make the paragraph
sound complete; a polished summary can add no meaning while erasing its force.
Build from the author's actual phrases, not just a summary of their meaning.
Keep the comparisons, ordinary words, asides, and emphatic turns that make the
speaker recognizable; arrange and connect them before replacing them with
equally accurate paraphrases. Roughness can carry emotion, humor, tension,
uncertainty, or rhythm. “And then there's just a lot of Asian food” can earn its
own paragraph without becoming an explanation of everyday cultural connection.
Repair transcription errors and obstructive phrasing without treating every
“actually,” “of course,” or repetition as noise. Neither roughness nor polish
is a virtue by itself.
Choose the register from the piece's purpose and Braden's reactions. Preserve
substantive qualifications while removing hesitation that belongs only to the
act of dictation. Preserve the degree of conviction too: changing “I would
argue” into “I wonder whether” can weaken the thought even when its subject
stays the same. Do not strengthen real uncertainty into certainty either.
A direct argument can present a position for examination
without turning it into his personal belief. Personal writing can remain
unresolved without narrating every step of the conversation that produced it.
## Hear The Whole Passage
Writing for the ear is part of developing the piece. Listen for how the words
carry the thought, giving that attention more weight when the work will be
spoken aloud. An “ear pass” names this editorial focus, not a separate workflow.
The active writing workflow, such as page-writing or journal-writing, continues
to own the conversation and edits.
Read connected passages at speaking speed and judge each sentence with what
surrounds it. The four ear tests below guide attention, not a report to fill out.
Hear what the writing is doing, then judge it by what this piece needs.
When a reaction reveals a mismatch, rehear the passage under that correction
and revise at the scope it illuminates. Use the destination's exploration
workflow when contrasting expressions would help; an authorized direct edit
needs no options menu. Reread the changed passage in context to hear whether
its movement and the author's posture still belong together. After a whole-piece
pass, check that the opening, strongest concrete detail, and ending still serve
the same thought.
For work intended to be heard, read [spoken destinations](references/spoken-destinations.md)
for the extra judgments a listener's experience requires. Ordinary editing
does not impose a narration or social-video standard on every piece.
### Economy
Identify what each sentence or paragraph contributes: a claim, example, turn,
qualification, emphasis, or the experience of discovering the thought. Try the
deletion test: would removing it preserve meaning, movement, and human posture?
Look for throat-clearing, doubled qualifiers, repeated explanations, generic
connections, or abstract nouns a concrete verb could replace. A sentence can
earn its time through hesitation, humor, contrast, or rhythm as well as new
information. Cut unearned time, not simply words.
### Rhythm
Listen for long clauses, stacked abstractions, repeated openings, awkward
mouth-feel, false starts, and phrasing whose predictability drains its force.
Hear where a breath naturally belongs and where emphasis lands. Split a
sentence when it helps the listener follow, not merely to create short lines.
A pause or repetition may build pressure, preserve uncertainty, or make a joke
land. Judge the words before trying to fix the delivery or timing.
### Movement and progressive disclosure
Trace what the reader or listener encounters in order and what each turn needs.
An argument may explain a mechanism, a scene may accumulate particulars, and a
question may stay open. An early conclusion can orient the reader; a later one
can let the example earn its force. Choose the order this expression needs
without imposing suspense, a moral, or a changed meaning at the end.
### Human recognition
Ask: “Could the author genuinely have brought this to another person?” Hear
whether the concrete details, odd phrasing, humor, uncertainty, and degree of
judgment still belong to the author. Remove polish that makes the passage more
solemn, certain, universal, or professionally scripted than its intended
expression. Recognition matters more than grammatical perfection; shaping the
writing should keep the person audible, including in newly discovered language.
## Respect The Form
A message, essay, button, and technical explanation have different jobs. Let
those jobs shape length and register while keeping the person audible. Clarity
does not require corporate scaffolding or false authority.
Use punctuation to make movement legible. Prefer periods. Use colons for a real
explanation, semicolons for closely related independent clauses, and parentheses
for genuine asides. Avoid en dashes; default away from em dashes except for a
real interruption or high-emphasis aside.
View on GitHub