The D4 Framework

Most bad documents aren't badly written.

They're badly ordered. Someone polished the sentences before the argument was settled. By the time anyone noticed the argument was wrong, the sentences had to go too. This is a four-level method, borrowed from software architects, for settling the argument first.

The failure this fixes

The eleven o'clock rewrite

Anyone who writes for a living knows this evening. The deck is due tomorrow and forty slides exist that look good: the boxes are aligned, the colours match the brand, someone has spent real hours on it. Then at eleven someone senior reads it end to end for the first time and says: I don't think this is the story.

Nothing is wrong with the slides, and every sentence is competent. The problem sits three levels above them. The argument those slides were built to carry was never agreed, so forty slides of careful work have to go to fix what amounts to a paragraph of thinking.

I have watched this happen to press releases, board memos, white papers, and my own essays. It is almost never a writing problem but an ordering problem. The work got done back to front, so the cheap decisions were made last and the expensive ones first.


Where the idea comes from

Architects solved this before we did

Software architects hit the same wall years ago. Their answer was the C4 model, a way of describing a system at four zoom levels: context is how the system sits in the world, containers are the big moving parts, components are what is inside each part, and code is the implementation.

The value is not the diagrams but the discipline the levels impose. You do not argue about a class name while the system boundary is undecided, because the boundary decides whether that class should exist at all. Each level has to be settled before the one below it is worth drawing.

A document has the same shape. So: D4.

D1 The blueprint. One idea, drawn once.
D2 Rooms. Where each thing will go.
D3 Furniture. The substance in each room.
D4 Paint and light. What people feel.

You can move a wall on a blueprint with an eraser. Moving the same wall once the house is built takes a demolition crew. Writing has walls too. They are just invisible, which is why people knock them down so casually at eleven at night.


The method

Four levels, in order

Each level has one job, one test that tells you it's finished, and one kind of output. You go down a level only when the level above it survives its test.

D1Define the core message

The one thing you are claiming, not the topic but the claim. "Notes on our pricing" is a topic, and "Our pricing punishes our best customers" is a message.

TestIs the central idea clear in one sentence, to someone who wasn't in the room?
OutputOne or two sentences, and that's the whole deliverable.
D2Break into major sections

Three to five sections that carry the message. This is where you pick the direction too: answer first, where you state the conclusion and then defend it, or answer last, where you build the evidence and let the reader arrive with you.

TestRead only the headers: does the argument still hold together?
OutputIndented bullets or headers, still no prose.
D3Fill in the content blocks

The substance: evidence, examples, data, objections, the quote you need. Write it plainly, because nobody is judging the rhythm yet.

TestCan each section stand on its own if you read it cold?
OutputShort paragraphs, lists, examples, figures.
D4Polish for delivery

Voice, rhythm, transitions, formatting, the line someone will quote back to you. Everyone wants to start here, and it is the only layer that is genuinely safe to leave until last.

TestWould you send this without a covering note explaining it?
OutputFinished prose: quotes, flow, formatting.

Watch it resolve

The same document, at four resolutions

Easier shown than described, so here is this article at each of its own levels. Step through them.

This article

Why the order matters more than the effort

Late mistakes are the expensive ones

This is the whole argument for working top down, and it comes straight from engineering: the cost of a change rises with how late you make it.

Change your D1 while it is still one sentence and you have spent thirty seconds. Change it after D2 and you restructure an outline. Change it after D3 and you bin your research. Change it after D4, which is the eleven o'clock rewrite, and you throw away every hour anyone spent making it beautiful. That is most of the hours.

What it costs to fix a broken message

The flaw is identical in every case, and only the moment you catch it changes.

D1 D2 D3 D4 sent COST OF THE FIX a new sentence re-do the research start again

The shape is the point, not the numbers. Most writers already know this curve from the wrong end of it.

Which gives you the most useful question in any document review: what level are we reviewing at? If the answer is D1 and someone is fixing commas, the meeting has gone wrong.


In practice

Five documents, four levels each

The method does not change with the form, only the vocabulary does.


How to actually do it

Indentation is the tool

You do not need software for this: indented bullets are the whole apparatus. Depth on the page maps to depth in the argument, so a structural problem becomes something you can see rather than something you have to feel.

If a D3 point will not sit under any D2 header, you have found a gap. If one section has eleven children and another has one, you have found an imbalance. Both are invisible in flowing prose and obvious in an outline.

› D1 The one thing you are claiming
› D2 Key section 1
› D3 Supporting detail A
› D3 Supporting detail B
› D2 Key section 2
› D3 Supporting detail C
› D4 The polished line, the data point, the quote
↑ notice this only exists at the very bottom

More than one author

Align at D1 and D2, or don't start

The framework earns most of its keep when a document has more than one parent. Teams that agree the core message and the section layout before anyone drafts prose almost never have the eleven o'clock evening. Teams that skip straight to drafting almost always do.

It also lets people come in at the right level without drowning in context. A subject expert can check your D3 without reading your prose. A designer can start on D4 visuals once D2 is locked. An editor does not have to work your argument out of finished paragraphs, because you can just show them the outline.

And it makes redrafting cheap in the place where redrafting pays. You can sketch four different D2 structures in the time it takes to write one good paragraph, and pick the best before committing to any of them.

What I want from a review culture is that the conversation moves to what level are we producing at, and that we spend our scrutiny on the D1s and D2s. That is where the thinking and the power of the message have to hold up. Everything below is craft, and craft is recoverable.


Writing with machines

You're the architect. The model is the builder.

This is the part that has changed most since I first wrote about D4, and it is why the framework matters more now than it did then.

Language models are very good at D3 and D4. They will draft your supporting sections, give you five versions of a paragraph, squeeze four pages into one, and polish the rhythm until it sings. They are much weaker at D1. Not because they cannot form a thesis, but because your thesis rests on things they do not have: what you have seen, what you are willing to stake, who you are trying to move.

You hold
  • D1 and D2. The claim, and the shape of the case for it.
  • The stake. What you are willing to be wrong about in public.
  • Tone and voice. What you sound like when you mean it.
  • The judgement call on every sentence the model hands back.
It builds
  • D3 drafting. Sections, examples, counterarguments you missed.
  • D4 polish. Flow, compression, formatting, alternatives.
  • Versions on demand. Three openings, you pick one.
  • The tedious passes: tightening, consistency, summaries.

The practical trick is this: your D1 and D2 are the prompt. Hand a model a topic and you get something generic, because you gave away the only decision it could not make. Hand it a sharp claim and a five-line outline and it will produce something that sounds like you meant it, because you did.

There is a real hazard here too. Models are so good at D4 that polish has stopped being evidence of thinking. A weak argument now arrives beautifully dressed, on time, with confident transitions. So the reviewer's job has quietly moved up: stop being impressed by the prose and go read the outline underneath it.


Quality gates

Knowing when a level is done

One question per level, and if the answer is no, you are not allowed downstairs yet.

D1Can I say this in one sentence, to someone who wasn't in the room?
D2Reading only the headers, does the argument still hold?
D3Does every section have structure, evidence, and a reason to exist?
D4Would I send this with no covering note, and be glad it was forwarded?

Start here

The whole method fits on a napkin

Open a blank document and write these four lines. Answer them in order, and do not let yourself answer one before the one above it is settled.

› D1 What is the one big idea?
› D2 What are the three to five sections that carry it?
› D3 What goes under each one?
› D4 What is the final polish: the quote, the data, the transition?

That is it: no tooling, no template library, no process to roll out. The discipline is entirely in refusing to work at a level before the one above it holds.

It will not make you a better writer overnight. It will stop you spending your best hours on sentences that were never going to survive, and give you a shared language for the conversation that decides whether a document works.

After enough eleven o'clock evenings, that turns out to be most of the game.

Notes
  1. A version of this first appeared on an internal blog in September 2025. The cost-of-change argument, the review-level idea, and the section on models are new.
  2. Its sibling piece on data is Percent of what?
  3. Written the way it describes: I held D1 and D2, a model did most of D3 and D4 and drew the diagrams.
  4. D4 borrows its shape from Simon Brown's C4 model.