Contents
The quotation looked perfect.
“Brevity is the soul of wit” was memorable, familiar, and apparently suited to a chapter about YAGNI. Then we checked its context in Hamlet. Polonius announces the virtue of brevity, states his conclusion, and keeps talking until Gertrude interrupts him with “More matter with less art.” Shakespeare was not handing writers a clean command to be short. He was making Polonius’s failure to respect his audience part of the joke.
We set the quotation aside.
Later, the chapter’s argument became more precise. YAGNI, short for “You Aren’t Gonna Need It,” warns developers against building speculative capabilities before a present need exists. Applied to writing, it was not about length. It was about value to the reader. A short aside could waste the reader’s time, while a long explanation could earn every page. In that argument, Polonius suddenly had a job. His extra language consumes his listeners’ time without improving what they understand.
The quotation returned because the essay needed it, not because we liked it.
That sequence captures one of the hardest scope decisions in nonfiction. A source, example, story, or observation can be accurate, interesting, and beautifully expressed without belonging in the piece you are writing. Sometimes it should be cut. Sometimes it should wait in your notes. Sometimes it has enough responsibility to become another essay.
Interest does not decide which one.
An Essay Cannot Serve Every Good Idea
Writers rarely struggle because they have nothing to say. Once research begins, the opposite problem arrives. One source leads to another. A useful history opens an adjacent argument. A supporting example exposes a controversy. An aside develops consequences that deserve more than two sentences.
The new material feels valuable because it is valuable. That does not make it valuable here.
Barbara Minto’s Pyramid Principle gives us a useful way to see the distinction. A document has a governing point. Supporting ideas answer the questions that point raises, and details support those ideas in turn. The hierarchy is not a ranking of how interesting the material is. It describes each part’s responsibility to the argument above it.
An interesting detail remains a detail while it helps the reader understand, evaluate, or apply the governing argument. It becomes a competing module when the reader must follow a second question, accept another set of premises, or wait through an independent line of reasoning before returning to the first.
That is the moment when a comment starts trying to become code.
The comparison needs a boundary. Good comments can preserve rationale the code cannot express, and a critical detail may be indispensable to an essay. The problem is not that explanation exists. The problem is that a subordinate component has acquired a responsibility the surrounding structure cannot support cleanly.
Four Honest Dispositions
When a detail starts pulling against the essay’s purpose, you have four honest choices.
| Disposition | Use it when | What happens next |
|---|---|---|
| Keep | The material performs a necessary role in the current argument. | Give it the space required to do that job. |
| Cut | The material adds no necessary reader value and has no credible independent use. | Remove it without ceremony. |
| Preserve | You can name a plausible future reader or question, but the material has not earned an independent piece. | Move it to notes with enough context to recover it. |
| Promote | The material has its own reader, governing question, evidence, and conclusion. | Design it as a separate component that can stand alone. |
These are scope decisions, not judgments of quality. Cutting a paragraph does not mean it was badly written. Preserving a source does not mean it has earned publication. Promoting a detail does not mean the current essay failed to contain it.
The dispositions also resist the sunk cost fallacy. The hours spent finding a study or polishing a story do not create an obligation for the reader to consume it. Research effort earns consideration. Reader value earns space.
Promotion Requires an Independent Contract
The web makes another article cheap to publish. That is useful, but low distribution cost can hide weak editorial judgment. Every footnote cannot become a companion essay merely because the content management system permits it.
Promotion requires an independent contract.
Before splitting material into another piece, answer five questions:
- Who needs this? Name a reader with a reason to choose the new piece.
- What question does it resolve? State one governing question that is not merely “Would you like more detail?”
- What must it establish locally? Supply the premises and definitions a cold reader needs.
- What evidence and examples does it require? Give it enough support to become an argument rather than an expanded aside.
- What will the reader understand or do afterward? Define an outcome that does not depend on returning to the parent.
If you cannot answer those questions, you probably have a note, not an essay.
This companion is an example. The Architecture of Nonfiction says that useful material can be added through supplemental documents when it has its own purpose. The sentence is sufficient for the parent essay. The decision process behind it requires a different reader contract, examples, and practical method. Expanding that process inside the parent would delay its argument. Developing it here lets both pieces retain their responsibilities.
The relationship should remain asymmetric. This essay can point back to the larger writing framework, but the larger essay must remain complete without this one. A companion extends. It does not hold a required premise hostage.
Promotion Cannot Hide Contrary Evidence
There is one hard boundary around this technique.
You may promote an adjacent argument. You may not export inconvenient evidence simply because it complicates the piece you want to write.
Suppose your essay argues that a particular engineering practice reduces incidents. During research, you find a credible study showing that the effect disappears for small teams. That qualification belongs in the current argument because it changes where the conclusion is true. Moving it into “a future article about exceptions” would protect the essay’s simplicity by making it misleading.
The governing argument controls where evidence is used. The evidence controls what the argument may conclude.
The distinction is practical:
- If the material answers a different question, promotion may improve both pieces.
- If the material changes the answer to the current question, the current piece must confront it.
- If the material merely repeats support already present, cut or preserve it.
- If the material is necessary but disproportionately large, revise the architecture before deciding that it belongs elsewhere.
Scope control is not permission to remove friction from your reasoning. Sometimes the difficult material is the work.
Preserve the Material Without Preserving the Detour
Cutting becomes emotionally expensive when the draft is the only place an idea exists. Writers keep weak asides because deletion feels permanent. A separate research file, source note, or future-ideas document changes that decision.
Preserve enough context to make the material usable later:
| Record | Why it matters |
|---|---|
| The source and relevant passage | You can verify the idea again without repeating discovery. |
| Your interpretation | You remember why the source mattered instead of inheriting a mysterious link. |
| The question it raised | A future piece begins with a reader problem rather than accumulated trivia. |
| Its disposition | You know whether it was cut, deferred, or promoted, and why. |
| Connections to existing work | You can reuse established context without duplicating the original argument. |
This is not a graveyard for sentences you could not bear to delete. Preserve material only when you can name a plausible future reader or question and record a concrete recovery path. If you cannot, cut it. The note needs a possible responsibility, or preservation becomes hoarding with metadata.
The practice also makes revision safer. You can remove a detour from the reader’s path without pretending the underlying research never happened. The draft becomes smaller. Your working context does not.
AI Makes Accumulation Cheaper, Not Attention
AI assistance changes the economics of this problem. Research can be discovered, summarized, compared, and organized faster. Alternate examples can be generated in seconds. Discarded passages can be preserved with almost no effort.
None of that reduces the reader’s cost.
In fact, cheap research makes overloading a piece easier. The author accumulates more accurate, interesting, and potentially useful material than the current argument can use. It is the human equivalent of blowing out an AI system’s context window: relevant information competes for attention until the governing task becomes harder to see.
The answer is not to stop exploring. It is to separate discovery from publication.
My work on the Observe, Orient, Decide, Act (OODA) decision loop began with a connection I wanted to investigate for one blog idea. The research revealed more than one useful question. The Loop Is the Easy Part focused on why orientation matters more than repeated observe-and-act cycles in autonomous AI systems. A Fighter Pilot Is Hiding in Your Engineering Practices traced the idea’s origins and movement through engineering practices.
The shared research did not justify two articles. The distinct theses did.
That is the productive version of promotion. Research becomes reusable infrastructure. Each piece consumes only the parts required by its reader contract, explains them locally, and links to the other when the connection adds value.
Make the Scope Decision Visible
When a detail keeps returning, stop renegotiating with it in the margins. Write a short decision record.
Apply the decisions in order. First, keep anything the present argument or reader requires. Second, keep and confront evidence that changes the current conclusion. Third, promote material that satisfies an independent contract. Fourth, preserve material tied to a plausible future reader or question and a concrete recovery path. Cut what satisfies none of those conditions.
One source or idea may receive more than one disposition after its responsibilities are separated. Keep the minimum explanation the current essay requires, and promote only the independent extension. An essay may need a study’s relevant finding while a separate piece examines the study’s method, history, or broader implications.
Material:
Current role:
Reader value:
Disposition: keep | cut | preserve | promote
Reason:
If promoted, governing question:
Evidence the current piece must still address:The record does not need to become bureaucracy. Its purpose is to separate four questions that enthusiasm tends to collapse: Is this true? Is this interesting? Does this piece need it? Does another piece have a real job for it?
Only the last two decide scope.
YAGNI protects the current reader from speculative detail. A modular body of work can grow through complete, related articles without forcing the original piece to absorb or anticipate every later idea. Minto’s hierarchy keeps supporting material subordinate to the question the reader came to resolve.
Together, those ideas produce a simple rule: do not ask whether the detail is good enough to keep. Ask what responsibility it has earned.
Receipts
- Argument hierarchy. Barbara Minto’s official site introduces the Pyramid Principle and its top-down organization of a governing point and supporting ideas.
- Modular composition. Adam Strantz’s “Modularity” describes content modules in terms of dependencies, reuse, independent updating, and composition.
- The quotation in context. The Folger Shakespeare Library’s Hamlet, Act 2, scene 2 contains both Polonius’s “brevity is the soul of wit” and Gertrude’s “More matter with less art.”
- The applied framework. The Architecture of Nonfiction develops the SOLID, DRY, YAGNI, and refactoring framework from which this scope-control method was derived.