Writing
What have you written that changed how someone thinks?
Writing is one of the most powerful capabilities because it develops thinking. You don't write to record finished thought — you write to discover it. Vague thought becomes precise only on the page.
The capabilities index files writing under Express. Its deepest power is in Think. Writing bridges the two: thought made precise, then made to move.
Writing solidifies; conversation dissolves. Speaking helps who's in the room. Writing helps everyone — including people who couldn't make it, future employees, and your future self.
| Without Writing Skill | With Writing Skill |
|---|---|
| Ideas evaporate | Ideas compound |
| Meetings repeat | Decisions documented |
| Onboarding takes months | Knowledge transfers fast |
| "What did we decide?" | "Here's the doc" |
AI drafts at speed and scale. Humans bring clarity of thought, voice, and judgment about what's worth saying. The thinking must come from you. The drafting doesn't have to.
This is the canonical know-how writing doctrine. Writing skills in this playbook point here.
Writing does three things: it creates clarity (precise words force precise thought), it builds comprehension (structure frees the reader's working memory for learning), and it persuades (moves people to act). This doc teaches the first two. Persuasion belongs to Selling.
Purpose & Audience
Before writing a word, answer three questions:
- What do I want the reader to think, feel, or do after reading this?
- Is every section clearly relevant to that purpose and this specific audience?
- Is the main point obvious in the first screen?
If you can't answer all three, you're not ready to write. You're ready to think.
Structure & Flow
- Does the piece have a clear beginning, middle, and end?
- Does each paragraph focus on one idea, with a topic sentence?
- Is the order of ideas logical, with smooth transitions between paragraphs?
The test: read the first sentence of every paragraph. Does the argument hold?
Clarity — Hemingway
| Cut This | Write This |
|---|---|
| "in order to" | "to" |
| "due to the fact that" | "because" |
| "at this point in time" | "now" |
| "it is important that" | (delete) |
| "basically" | (delete) |
- Sentences short on average — under 20 words, one main thing each
- Concrete, specific language over vague abstractions
- Simple words over fancy ones unless jargon is truly needed and explained
- Cut needless words, repetitions, and filler on every pass
Three questions from Hemingway: What are you trying to say? Have you said it? Can you say it more simply?
Short sentences. Anglo-Saxon over Latin. Strong verbs over adjectives. Iceberg theory.
- Short sentences. One main thing each. Under 20 words. Fragments when they hit harder.
- Anglo-Saxon over Latin. Use, not utilise. Start, not initiate. Show, not demonstrate. End, not terminate. The shorter root hits harder.
- Verbs over adjectives. "The protocol reroutes" not "the protocol is resilient." Action, not description.
- Cut adverbs. If the verb needs help, replace the verb. "Runs quickly" is two words where "sprints" is one.
- Never write the emotion. Write the action that causes it. The reader feels what you don't say.
- Iceberg theory. The dignity of movement is due to seven-eighths being below the surface. What you leave out powers what you include.
- End on impact. The last sentence stays. Never end with a summary of what you said.
- Three questions. What are you trying to say? Have you said it? Can you say it more simply?
Comprehension — The Learning Architect
Experts forget what it's like not to know. This is the curse of knowledge — the expert can no longer retrieve the state in which they didn't understand. The reader arrives without your context. Writing bridges that gap, or it doesn't.
The diagnostic: explain it to a smart 12-year-old. Not to talk down — to be precise. If you cannot, you haven't finished thinking. [source: Feynman technique]
Every reader arrives with a fixed working-memory budget [source: Sweller, Cognitive Load Theory]. Burn it on complexity and they drop. Spend it on learning and they grow. Three dials control the budget:
- Intrinsic load — the inherent complexity of what you're teaching. Sequence familiar to unfamiliar. New concepts on old scaffolding. Start where they are, not where you are. [heuristic]
- Extraneous load — noise the reader must filter before learning anything: jargon, passive voice, buried structure, meandering paragraphs. Every word that doesn't earn its place is extraneous load. Cut it. What remains goes to learning.
- Germane load — the productive effort of forming new schemas. This is the goal. Every structural choice either frees working memory for germane work or burns it on the other two.
The test: if the reader must re-read a sentence to parse it, they paid extraneous when they could have paid germane.
The learning arc — sequence is invisible when it works. Stall the reader and the arc failed. Move simple to complex, concept to application [heuristic]:
- Hook — why this matters before what it is
- Foundation — one concept per section, no more
- Build — layer complexity on what they now know
- Visual — diagrams that carry weight words can't
- Application — worked examples, not abstract principles
- Elaboration — further reading and open questions for the reader who wants to go further
The paragraph formula — one claim per paragraph, no hedges. Then evidence: a number, an example, a story. Then the so-what: connect to the reader's world.
Generalisations without examples are useless. Examples without generalisations are pointless. Marry both.
Voice & Tone
- Does it sound like a real person speaking, not a corporate memo or academic robot?
- Is the tone appropriate for the reader — expert, friend, executive, newcomer?
- Where it fits, do you speak directly using "you" and clear calls to action?
The read-aloud test catches what the eye misses. If you wouldn't say it to someone's face, rewrite it.
Sentence Craft
| Weak | Strong |
|---|---|
| "The feature was shipped by team" | "The team shipped it" |
| "Made a decision to proceed" | "Decided" |
| "Is very important" | "Matters" |
| "Seems to basically indicate" | "Shows" |
- Active voice over passive — the subject does the thing
- Vary sentence openings and lengths to avoid monotony
- Strong, specific verbs — not weak ones propped up by adverbs
- Related words kept close together so the sentence parses easily
Evidence & Examples
- For each key claim, give a concrete example, image, or evidence
- Show rather than tell — "Revenue dropped 40%" not "things went badly"
- Anticipate and briefly address obvious questions a smart reader would have
Claims without evidence are opinions. Opinions without authority are noise.
Polish
- Grammar, spelling, and punctuation clean enough that nothing distracts
- Technical terms used correctly and consistently throughout
- Others' ideas clearly distinguished and credited
- Final pass: cut at least a few more words that don't earn their keep
Core Patterns
- Rewriting is writing — First drafts capture. Rewrites clarify. The only kind of writing is rewriting.
- Headlines carry weight — Specific, value-driven, compelling. More people read the headline than the body copy.
- Timing — Now is often wrong. Sleep on it before sending. Let it filter through the sieve of time.
- Publish before perfect — Feedback teaches more than revision. Ship, learn, rewrite.
The Shadow
Perfectionism. Writing as procrastination. Polishing instead of publishing.
Mistaking eloquence for clarity. The best writing is the writing that ships.
By Archetype
| Archetype | Writing Style |
|---|---|
| Philosopher | Writes to think — clarity emerges through the act |
| Engineer | Writes to document and scale — systems over stories |
| Dreamer | Writes to inspire — vision into words |
| Coach | Writes to unlock — questions that open doors |
Context
- Critical Thinking — Writing develops thinking; the page is where thought becomes precise
- Storytelling — Writing with narrative arc
- Selling — When writing serves persuasion
- Reading — The input side of writing
- Presenting — Writing for the spoken word
- Async Communication — Where writing discipline lives
- Writing Tools — AI amplification at 70%
Questions
If writing solidifies and conversation dissolves — what did you lose last week because you said it instead of writing it?
- Hemingway cut ruthlessly. The Learning Architect sequenced carefully. Both built comprehension. Which discipline do you resist — and what would change if you adopted it for 30 days?
- Where in your work does quality still depend on verbal explanation that a well-written document would make unnecessary?
- What's the most important thing you know that you haven't written down — and who loses when you don't?