skills/instructions/references/WRITING_EDITORIAL_REFERENCE.md

# WRITING EDITORIAL REFERENCE

This file supports the Writing Assistant's production instructions. It is a reference for judgment, not a second instruction hierarchy. When this file and the production instructions appear to differ, follow the production instructions.

## 1. SOURCE MAP AND PROVENANCE

### George Orwell — *Politics and the English Language*
Best used for:
- precision versus vagueness
- stale imagery and prefabricated phrasing
- euphemism and concealment
- simple verbs versus inflated verbal machinery
- the connection between unclear language and unclear or insincere thought

Use Orwell as a diagnostic source, not as an absolute style code. His own final rule permits breaking the preceding rules rather than producing barbarous prose.

### William Zinsser — *On Writing Well*
Best used for:
- clutter and subtraction
- unity
- leads and endings
- nonfiction organization
- audience attention
- rewriting
- simplicity without flattening voice
- practical professional and nonfiction prose

Zinsser's advice often assumes a reader whose attention can be lost. Apply that assumption most strongly to nonfiction that competes for attention or must be scanned.

### Stephen King — *On Writing*
Best used for:
- vigorous verbs
- revision discipline
- fiction craft
- scene and dialogue
- writing for a specific ideal reader
- the "second draft = first draft − 10%" revision heuristic
- distrust of needless adverbs and inflated prose

King is the corpus's main fiction source. Do not generalize fiction-specific practice into every genre.

### Verlyn Klinkenborg — *Several Short Sentences About Writing*
Best used for:
- knowing what a sentence says, does not say, and implies
- sentence-by-sentence attention
- distrust of unnecessary explanation
- short sentences as a diagnostic tool
- composition at the point of the sentence
- detecting hidden assumptions and received habits
- allowing larger structure to emerge from clear sentences

Klinkenborg deliberately challenges conventional signposting, topic sentences, reader-management language, and preplanned structures. His method is most useful when prose can carry its own order without heavy navigation.

### Virginia Tufte — *Grammar as Style* and *Artful Sentences*
Treat these as one closely related source tradition, not two independent votes. *Artful Sentences* explicitly grows out of *Grammar as Style*.

Best used for:
- syntax as a repertoire of choices
- end-position and emphasis
- short sentences
- noun and verb phrases
- coordination and subordination
- sentence openers and inversion
- free modifiers
- appositives
- parallelism
- cohesion
- syntactic symbolism
- passive voice as a legitimate instrument in context

Tufte catalogs successful possibilities rather than merely errors. Use her generatively when a sentence needs rebuilding.

### Gary Provost / Bookey file
The uploaded `100 Ways To Improve Your Writing` PDF is a Bookey-produced summary and contains Bookey commentary. It is not reliable as primary evidence for "Provost says..." claims. Replace it with the actual book when possible. Until then, use it only as secondary material and do not allow its commentary to outweigh primary sources.

## 2. THE SIX RECURRING SOURCE TENSIONS

These are not resolved by counting authors. The production instructions contain the operative rules; this section records why those rules exist.

### Passive voice
Orwell, Zinsser, King, and Klinkenborg usually push toward active constructions because passives can hide agency, weaken verbs, or produce bureaucratic vagueness.

Tufte's *Grammar as Style* gives the countercase: passive voice can improve emphasis, cohesion, information order, subject continuity, modification, parallelism, and thematic effect.

Editorial test:
- Who or what should occupy the subject position?
- Does the agent matter?
- Where should the sentence's news land?
- Does the passive improve cohesion with the previous sentence?
- Does an active rewrite become clumsier or misplace emphasis?

Do not ask "active or passive?" in isolation. Ask what each version makes the sentence do.

### Connectives, transitions, and topic sentences
Zinsser, Tufte, King, and the Provost summary permit or encourage signposting when it helps navigation. Klinkenborg distrusts connective language that insists on logic rather than embodying it.

Editorial test:
- Does the transition mark a real turn the syntax and sequence do not already make clear?
- Is the reader likely to scan?
- Is the piece instructional, argumentative, technical, or report-like?
- Does removing the signpost make the relation harder to follow?
- Is a word such as "therefore" asserting a relation the evidence has not earned?

Use signposts as navigation, not as substitutes for reasoning.

### Distinctness
Zinsser, Klinkenborg, and the Provost tradition treat style as an outcome rather than an accessory.

For an LLM, however, generic competence is a real failure mode. The useful compromise is diagnostic:
- Do not "add voice."
- Do not pursue unusualness.
- If prose feels interchangeable, ask whether the source material contains a more specific perception, distinction, selection, judgment, emphasis, or rhythm that the draft has flattened.
- If not, keep the prose plain.

Distinctness should emerge from supported thought and attention.

### Sentences first or structure first
Zinsser and King often repair large-scale organization before line work. Klinkenborg argues that clear sentences can reveal larger form.

Editorial test:
- If the argument, scope, sequence, or evidence is wrong, work top-down.
- If the thought is basically sound but the prose is dead, confused, or rhythmically inert, work bottom-up.
- Do not line-edit a broken architecture.
- Do not rebuild architecture merely to avoid doing precise sentence work.

### Who is the reader?
Zinsser emphasizes a distracted reader. Klinkenborg rejects preconceiving the reader's limitations. King writes for a particular ideal reader.

Editorial test:
- Use the user's named reader when supplied.
- Otherwise imagine a specific competent reader.
- Respect intelligence and inference.
- Respect limited time and attention.
- Do not over-explain merely because an abstract "reader" might miss something.

### Openings
Zinsser stresses the first sentence's need to earn the next. Klinkenborg rejects tricks and urges writers to begin the piece rather than introduce it.

Genre resolves much of the tension:
- persuasive, journalistic, commercial, application, and competitive prose usually need quick relevance or momentum
- reflective, personal, literary, and scholarly prose can open more quietly
- both reject throat-clearing

A hook is not the goal. A real beginning is.

## 3. CUTTING AS A REVISION PROCEDURE

The corpus strongly favors subtraction, but the numerical advice should be treated as a stress test rather than a quota.

Useful benchmarks:
- King's working heuristic: second draft about 10% shorter than the first
- Zinsser's stronger claim: many first drafts can lose far more, even approaching half, without losing substance
- Klinkenborg's principle: every word is optional until its necessity is proved

Use these questions:
- Do I need this sentence at all?
- Does this example reveal something new?
- Is this modifier doing work?
- Is this explanation already implicit?
- Is this transition carrying logic the sequence should carry?
- Is this conclusion repeated?
- Does the sentence say the same thing twice in different abstractions?
- If I cut this, what necessary thing disappears?

Do not cut:
- required evidence
- necessary qualification
- reasoning that makes a conclusion earned
- context the reader needs
- useful tonal variation
- repetition that performs a deliberate rhetorical function
- uncertainty that prevents overstatement

If a draft is underdeveloped, expansion can be the correct revision.

## 4. SENTENCE LENGTH, RHYTHM, AND INFORMATION FLOW

### Length
Sentence length has no ideal number. Judge it by function and intelligibility.

Short sentences can:
- clarify
- reset
- emphasize
- accelerate
- interrupt a pattern
- expose what a thought actually contains

Long sentences can:
- accumulate
- qualify
- subordinate
- create sequence
- delay emphasis
- hold related material in one syntactic movement

Break a long sentence when the reader must reconstruct its beginning to understand its end.

A run of same-length or same-shaped sentences can deaden prose even when every sentence is grammatical.

### Information flow
Notice:
- what the reader already knows
- what is new
- what becomes subject
- what carries the action
- what receives emphasis
- what lands at the end

End-position often carries emphasis. A weak ending may need reordering, not stronger vocabulary.

Do not turn "put new information last" into a universal rule. Use it as one test among several.

## 5. TUFTE'S SYNTACTIC REPERTOIRE

When trimming cannot solve a sentence, consider rebuilding it with a different structure.

### Short kernel sentence
Useful for directness, emphasis, reset, contrast, or juxtaposition.

### Expanded noun phrase
Useful when identification, classification, or accumulated description belongs around a noun. Watch for noun-heavy prose that would be stronger as action.

### Expanded verb phrase
Useful for controlling action, aspect, sequence, qualification, and emphasis. Prefer strong verbs when inflated verbal machinery adds nothing.

### Coordination
Joins elements at equal grammatical rank. Useful for accumulation, balance, pace, and parallel relation.

### Subordination
Marks hierarchy among ideas. Useful when one fact supplies condition, cause, concession, time, qualification, or background for another.

### Sentence openers and inversion
Moving material before the ordinary subject-verb sequence can alter emphasis, rhythm, transition, or point of view. Use only when the gain is clear.

### Free modifiers
Modifiers can branch left, middle, or right from the sentence's core. They are useful for adding detail without overloading the core clause.

### Appositives
Rename or specify a noun. Useful for compact explanation, qualification, or layered identification.

### Parallelism
Repeating grammatical structure can clarify relationships, create rhythm, emphasize contrast, or build force. Parallelism should sharpen meaning, not merely decorate it.

### Cohesion
Sentences can cohere through repeated subjects, lexical echoes, pronouns, grammatical continuity, transitions, and deliberate information order.

### Passive transformation
Useful when the receiver of an action deserves subject position, the agent is irrelevant or already known, cohesion requires a stable subject, or the sentence's important news belongs later.

### Syntactic symbolism
Sometimes sentence structure can unobtrusively enact sequence, hesitation, accumulation, interruption, balance, compression, or other aspects of meaning. Use sparingly. If the reader notices the technique more than the subject, it is probably too conspicuous.

## 6. RECURRING DEFECT PATTERNS

Use this as a diagnostic inventory, not a checklist to apply mechanically.

### Meaning and agency
- passive or impersonal construction conceals a responsible agent
- abstraction hides who did what
- euphemism weakens or disguises the underlying fact
- pronoun points ambiguously or catches the wrong nearby antecedent
- "the" or another definite reference assumes something has been established when it has not

### Weak action
- noun phrase replaces a stronger verb
- weak verb carries the sentence while the real action sits in a noun
- "as" or "with" construction carries action that deserves its own verb
- adverb repeats information already contained in the verb
- verbal padding inflates a simple action

### Modification
- opening modifier does not grammatically modify the subject
- modifier sits too far from what it modifies
- long modifier overloads the middle of a sentence when it would land more clearly elsewhere
- adjective or adverb supplies evaluation that the evidence should provide

### Logic and explanation
- connective asserts a relation the sentences have not earned
- sentence explains an implication the reader already has
- example merely repeats the preceding abstraction
- conclusion appears before the reasoning that would make it persuasive
- repeated conclusion appears in several phrasings without adding anything
- tidy resolution removes uncertainty the material still contains

### Consistency
Check unity of:
- pronoun/person
- tense
- mood
- point of view
- register
- level of formality
- terminology

A shift is not automatically wrong. It should be intentional and intelligible.

### Proportion and emphasis
- hyperbole is spent on a small claim
- climactic language arrives before the material earns it
- important information is buried
- sentence ends on its least important word
- several sentences receive equal rhetorical emphasis when one should dominate

### Generic professional prose
Watch for:
- unsupported claims of passion, impact, ambition, innovation, authenticity, leadership, curiosity, or thoughtfulness
- stock openings and endings
- "I am excited to..."
- generalized praise without particulars
- abstract self-description where supplied evidence could let the reader infer the quality
- polished language that erases the writer's actual judgments or priorities

Do not replace these automatically with literary language. Replace abstraction with supported substance when available; otherwise prefer plainness.

## 7. COMPOSITION, NOT ONLY REVISION

The source corpus contains substantial advice about generating prose, not just repairing it.

Before drafting:
- clarify purpose
- identify the governing question, claim, observation, tension, or request
- decide what evidence is actually available
- decide what the reader must know and what can remain implicit
- choose an order that serves understanding rather than defaulting to chronology
- for nonfiction, consider unity of pronoun, tense, mood, scope, and point of view
- for personal prose, do not invent a scene merely because a scene would be vivid

During drafting:
- make one sentence say one intelligible thing before asking it to do more
- allow particulars to generate thought
- let examples change what the reader understands
- resist filling space with commentary after the point has landed
- if a sentence will not become clear, reconsider the thought it is trying to carry

## 8. ORWELL'S HONESTY TEST

Factual accuracy is necessary but not sufficient.

Ask:
- What am I trying to say?
- What words actually express it?
- What image or phrase would make it clearer?
- Is this fresh enough to have meaning, or merely familiar?
- Can it be shorter?
- Am I saying anything unnecessarily ugly, vague, inflated, or evasive?
- Is the language disguising an uncomfortable agent, judgment, or consequence?

Rules are subordinate to truthful, intelligible prose.

## 9. EXAMPLES AND MODEL SENTENCES

The source books teach heavily by example. In production, however, do not imitate their authors' distinctive style or transplant memorable sentences.

Use examples to understand:
- what a structure can do
- how emphasis changes when syntax changes
- how a cut changes force or clarity
- how implication can replace explanation
- how a sentence's rhythm interacts with meaning

When generating for the user, write for the user's purpose and voice.

## 10. REFERENCE PRINCIPLE

The corpus is not a single voice. Its usefulness comes partly from disagreement.

When sources differ:
1. identify the function the sentence or piece needs to perform
2. identify the genre and reader
3. test the competing options in context
4. choose the version that improves meaning, emphasis, comprehension, honesty, and voice
5. do not justify a choice merely by citing a rule

The production instructions are the decision layer. This file is the craft library behind those decisions.